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TYMSHARE MANUALS 
SYMBOL CONVENTIONS 



The symbols used in this manual to indicate Carriage Return, Line Feed, and ALT 
MODE/ESCAPE are as follows: 



Carriage Return: 

Line Feed: 

ALT MODE/ESCAPE: 



2 



NOTE: 



This symbol will be printed as 
many times as it is required to 
hit this key. 



Control Characters 



Control characters, typed by pressing and holding the CTRL key in conjunction with 
an alphabetic character, are denoted by a superscript c. For example, D c denotes 
Control D. 

Action At The Terminal 

To indicate clearly what is typed by the computer and what is typed by the user, the 
following color code convention is used: 

Computer: Black User: Red 



INTRODUCTION 



EDITOR provides the user of the Tymshare system with an unusually flexible set of 
editing commands. The EDITOR user may 

• Edit individual lines of text. 

• Edit commands as they are typed. 

• Insert a line or range of lines into the text. 

• Delete a line or range of lines from the text. 

• Move a line or range of lines to another position in the text. 

• Copy a line or range of lines in the text. 

• Make substitutions throughout the text. 

• Use most of the commands repetitively without being required to retype them. 

• Write small editing programs to do much of his editing work for him. 

ABOUT THIS MANUAL 

This manual is intended primarily for reference. However, it is also a readable and ef- 
fective text for the potential EDITOR user. 

For those who are beginners at computer aided text editing, we suggest studying 
Tymshare's EDITOR Manual, Instant Series, before this manual is attempted. 

Section 1 of this manual is designed to familiarize the reader with the fundamentals of 
EDITOR, or to serve as a review for those who have already been introduced to EDITOR. 

Sections 2 through 5 constitute the principal reference part of the manual. All 
EDITOR commands are discussed fully in these sections. However, the student of 
EDITOR will find this part of the manual, especially the examples, easier to understand if 
he reads Section 1 first. 

Section 6 contains editing examples demonstrating various techniques. 

The appendices provide a summary of EDITOR'S error messages, a convenient table 
showing the definition of the current line after each EDITOR command, some infor- 
mation about the terminal, and a summary of EDITOR'S commands and control 
characters. 



SECTION 1 
INTRODUCTION TO EDITOR: AN EXAMPLE 



As an introduction to EDITOR we present a complete example of text editing with 
EDITOR. 

We begin with the first steps in using any Tymshare language, logging in and calling the 
language: 

After the connection with the computer has been properly made, the computer replies 
with: 

PLEASE LOG IN p The user types a Carriage Return. 

ACCOUNT: A3p He types his account number (A3 in this case) fol- 
lowed by a Carriage Return. 

PASSWORD: p The user types his password followed by a Carriage 

Return. The password does not print. 

USER NAME: JONES p He types his user name. 

PROJ CODE: K-123-K p He types a project code (K-123-K in this case). A 

project code is optional; if no project code is desired, 
type a Carriage Return in response to the system's 
request. 

TYMSHARE 12/24 11:20 The user is properly connected to the system. The 

- EDITOR ~) c ' asn (~ ' on tne '•** indicates that he is in the EXEC- 

UTIVE. EDITOR may now be called by typing 
EDITOR followed by a Carriage Return. EDITOR re- 
plies with an asterisk (*) when it is ready to accept a 
command. 

* APPEND p The APPEND command allows the user to enter his 

87100 ALBUQUERQUE, NEW MEX p text. He uses the control characters A c and Q c to 

98310 BREMERTON WASHINGTON p make corrections as he types. 

90241 DOWNYA°*-EY CALIF p 

98345 KEYPORT WASHINGTON p 

87544 LOS ALAMOS NEW MEX p 

94025 MENLO CALIF p 

00003 PEORIA ILLp 

95112 SAN JOSE CALIF p 

95112 SEATTLE WASHQ c t 

98124 SEATTLE WASHINGTON p 

D c Control D terminates the APPEND command. 

* I The / command prints his entire text on the terminal. 

87100 ALBUQUERQUE, NEW MEX 

98310 BREMERTON WASHINGTON 

90241 DOWNEY CALIF 

98345 KEYPORT WASHINGTON 

87544 LOS ALAMOS NEW MEX 

94025 MENLO CALIF 

00003 PEORIA ILL 

95112 SAN JOSE CALIF 

98124 SEATTLE WASHINGTON 



» WRITE p He saves his text on a disk file, called /ZIP/. 

TO /ZIP/p 

NEW FILEp 
69 WORDS. 

* 1EDIT -) The user edits line 1. Using control characters, he de- 

87100 ALBUQUERQUE, NEW MEX letes the comma. 

Z C R87100 ALBUQUERQUES C %D C NEW MEX 

* 1/ He prints the new line 1. 

87100 ALBUQUERQUE NEW MEX 

* 'MENLO'EDITp He edits the line containing the text MENLO and 

94025 MENLO CALIF prints it. 

Z c O94025 MENLOE^ PARKE C >D C CALIF 

* '940257 

94025 MENLO PARK CALIF 

* '0000'DELETE p He deletes the line containing the text 0000. 

» SUBSTITUTE p He abbreviates the word WASHINGTON throughout 

"WASHD C " FOR "WASHINGTOND " the text. 

WAIT? N 

3 

* / He prints the entire edited text. 

87100 ALBUQUERQUE NEW MEX 

98310 BREMERTON WASH 
90241 DOWNEY CALIF 
98345 KEYPORT WASH 
87544 LOS ALAMOS NEW MEX 
94025 MENLO PARK CALIF 
95112 SAN JOSE CALIF 
98124 SEATTLE WASH 

* WRITE -> The user saves the edited text on the same file he cre- 

TO /ZIP/p ated earlier, /ZIP/. 

OLD FILE p 
58 WORDS. 

» QUIT p The user leaves EDITOR. 

- LOGOUT p To leave the system, he uses the EXECUTIVE com- 

TIME USED 0:8:03 mand LOGOUT. After the system types the amount 

PLEASE LOG IN: of tme he has used, he can hang up or let someone 

else log in. 



Before proceeding with a step-by-step analysis of 
our example, we note a few general characteristics of 
EDITOR. 

EDITOR is an editing language consisting of various 
editing commands, such as APPEND and SUBSTI- 
TUTE. The "data" upon which the commands oper- 
ate is simply text. 

In our example, the text consists of alphabetic and 
numeric data; namely, ZIP codes and their corre- 



sponding cities and states, which the user might wish 
to use as input to a program in one of Tymshare's 
programming languages. However, EDITOR itself is 
not a programming language, but a general purpose 
text editor. Any text that can be typed on the 
Tymshare terminal can be accepted by EDITOR. For 
example, this manual could be typed into EDITOR 
and updated from time to time. 

Once he has called EDITOR, the user has EDITOR'S 
large text area available to him. Text in the text area 



may be edited quickly and easily using EDITOR'S 
commands; the edited text may be saved on a disk 
file, printed at the terminal, or punched on paper 
tape. In general, the use of EDITOR will usually 
involve 

• Input of text to the text area. 



• Editing of the text. 

• Output of text from the text area. 

Our example shows some ways of doing all of 
these. We shall now discuss them in more detail, in the 
order that they appear in the example. 



INPUT OF TEXT: THE APPEND COMMAND 



Text may be entered into EDITOR'S text area 
from paper tape, from a disk file, or directly from the 
terminal. In our example, the user wishes to enter his 
text from the terminal, so he uses the APPEND com- 
mand. This command has the following form: 



* APPEND ? 

the text to be entered 

D c 



? 



After typing APPEND followed by a Carriage Re- 
turn, the user types his text. The command is termi- 
nated by a Control D (D c ), which must immediately 
follow the last Carriage Return of the text. EDITOR 
will then type the asterisk, indicating that it is ready 
to accept another command. 



CONTROL CHARACTERS 



Control characters have many uses in EDITOR. 
They are typed by depressing and holding the CTRL 
key and then typing the desired letter, D in the above 
case. They do not print on the terminal; however, 
EDITOR will make some response when the user types 
a control character. In the above case, it typed an as- 
terisk to indicate that the D c did in fact terminate the 
APPEND. 

NOTE: Throughout this manual, control charac- 
ters will be indicated by the superscript c; for exam- 
ple, D° denotes Control D. 

Text entered during APPEND may be edited while 
it is being typed by using control characters. 

CONTROL A: DELETING 
THE PRECEDING CHARACTER 

In our example, the word DOWNEY was mis- 
spelled as DOWNY in the third line of text. To cor- 



rect this error, the user types a Control A to delete 
the preceding character, Y. EDITOR types a back ar- 
row (<-) to indicate that Control A is used, thus: 

90241 DOWNYA c «-EY CALIF-, 



CONTROL Q: DELETING 
THE PRECEDING LINE 

Similarly, in the last line of text entered during 
APPEND, the user noticed that he had typed the 
wrong ZIP code at the very beginning of the line. He 
types a Control Q to delete the entire line. EDITOR 
types an up arrow (t) and returns the carriage for the 
user, who then types the correct line: 

951 12 -SEATTLE WASHQ c t 
98124 SEATTLE WASHINGTON ? 
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OUTPUT OF TEXT 



THE / COMMAND: PRINTING 
TEXT AT THE TERMINAL 

Very often it is useful to have the contents of the 
text area printed at the terminal. The command to do 
this is the /. Unlike other commands, the / acts im- 
mediately after it is typed, so there is no need to fol- 
low it with a Carriage Return. EDITOR returns the 
carriage and prints the contents of the text area. 

In the example, the user typed a / after he had 
terminated the APPEND, thus: 

»/ 

87100 ALBUQUERQUE, NEW MEX 

98310 BREMERTON WASHINGTON 

90241 DOWNEY CALIF 

98345 KEYPORT WASHINGTON 

87544 LOS ALAMOS NEW MEX 

94025 MENLO CALIF 

00003 PEORIA ILL 

95112 SAN JOSE CALIF 

98124 SEATTLE WASHINGTON 



Note that there is no evidence of the control char- 
acters used during APPEND. Printing the contents of 
the text area after APPEND can be especially useful 
when many control characters have been used. 

THE WRITE COMMAND: 
SAVING TEXT ON A FILE 

After printing the contents of the text area, the 
user decides to save his text on a file, even though he 
has more editing to do. This practice assures him that 
his text will always be safe. Even if he accidentally 
destroys some of it, it can always be read back into 
the text area from the disk file. 



The command to write text on a file is 

WRITE p 

After this is typed, EDITOR responds with 

TO 

The user then types the name of the file on which he 
wishes to save the text, followed by a Carriage Re- 
turn. The file name may consist of any characters be- 
ginning and ending with slashes. NOTE: The name 
may not contain a slash except as the first and last 
character. l In our example we have the file name 

/ZIP/ 

If the user does not already have a file with the 
chosen file name in his directory, EDITOR responds 

with 

NEW FILE 

The user may then type a Carriage Return, telling 
EDITOR to save the text on the file, or he may press 
the ALT MODE or ESCAPE key to abort the 
command. 

If the user does have a file with the chosen name, 
EDITOR will respond with 

OLD FILE 

and again, the command can be confirmed with a 
Carriage Return or aborted with an ALT MODE or 
ESCAPE. If the command is confirmed, the text will 
be written on the file and whatever was previously in 
the file will be lost. 

After a WRITE command has been confirmed, 
EDITOR prints the number of words written on the 
file (3 characters = 1 word) and returns control to the 
user. Thus, in our example we have 

• WRITE p 
TO /ZIP/p 

NEW FILEp 
69 WORDS. 



EDITING TEXT IN THE TEXT AREA 



The various editing commands available to the 
EDITOR user enable him to manipulate text in many 
ways. In our example the user edits individual lines of 
text, deletes a whole line of text, and makes substitu- 
tions throughout the text. 



LINE ADDRESSING 

To edit a line of text, or to manipulate whole lines 
of text, a method of telling EDITOR which line or 
lines are to be changed is needed. This is accomplished 



1 - Other kinds of file names are also allowed. These are discussed under Rules For Naming Files, Page 21 . 



by various kinds of line addressing. In our example, 
two methods of line addressing are used: 

1. Addressing a line by its EDITOR line number. 

2. Addressing a line by text within the line. 

EDITOR assigns a line number to each line of text. 
The line numbers are always consecutive integers be- 
ginning with 1 . Thus, to edit the first line of text, the 
user types 

1EDIT ? 

When he wishes to edit the line containing the 
word MENLO, the user finds it easier to address the 
line by text within the line, so he types 

'MENLO'EDIT ? 

THE EDIT COMMAND 

This command is used to make changes within a 
line of text. It has the form 

aEDIT p 

where a is an address of the line to be edited. After 
the Carriage Return following the command, EDITOR 
prints the addressed line, called the old line, and re- 
turns the carriage. To change the line, the user may 
simply retype the new line below the old line and end 
the edit with a Carriage Return. However, control 
characters may be used to edit more efficiently. The 
first such use of control characters in our example is 
in the edit of line 1 : 

* 1EDIT ? 

87100 ALBUQUERQUE, NEW MEX 
Z C R87100 ALBUQUERQUES^oD NEW MEX 

* 

First, a Control Z is typed, followed by the char- 
acter R, to copy the entire line up to and including 
the R. EDITOR copies the specified characters. Then 
the user types the remaining three characters pre- 
ceding the comma (Q, U, and E). He types a Control 
S to delete the corresponding character in the old line, 
the comma. A Control D copies the rest of the old 
line to the new line and ends the edit. 

After editing the line, the user prints it to see what 
it now looks like: 

•1/ 

87100 ALBUQUERQUE NEW MEX 

• 

An example of inserting text with control charac- 
ters is shown in the next use of the EDIT command: 

• 'MENLO'EDIT p 
94025 MENLO CALIF 



Z c O94025 MENLOE c < PARKE C >D C CALIF 

• '940257 

94025 MENLO PARK CALIF 

• 

Again, Control Z is used to copy up to and includ- 
ing the character typed after it, an O in this case. 
Then Control E is used to insert a space and the word 
PARK, as follows: First, the user types a Control E; 
EDITOR responds with a left angle bracket (<). Then 
a space followed by the word PARK is typed. An- 
other Control E terminates the insert; this time EDI- 
TOR responds with a right angle bracket (». Again, 
Control D copies the rest of the old line and ends the 
edit. 

The command 

'940257 

prints the entire edited line. 

THE DELETE COMMAND 

To delete a line of text, the command 

aDELETE ? 

is used, where a is an address of the line to be deleted. 
Thus, to delete the line 

00003 PEORIA ILL 

in the example, the user types 
'0000'DELETE p 

THE SUBSTITUTE COMMAND 

The last editing done in the example is abbreviating 
the word WASHINGTON everywhere it occurs in the 
text. To do this, the SUBSTITUTE command is used: 

« SUBSTITUTE ? 

"WASHD C " FOR "WASHINGTOND " 

WAIT? N 
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First, the user types SUBSTITUTE followed by a 
Carriage Return. EDITOR then prints a double quote. 
The user types the characters to be inserted, WASH, 
terminated by a Control D. EDITOR prints 

" FOR " 

to prompt the user. Now he types the characters to be 
replaced, WASHINGTON, again terminated by a Con- 
trol D. EDITOR prints another double quote, returns 
the carriage, and asks the question 

WAIT? 



In our example, the user types an N (for No, do 
not wait). 1 There is no need to type a Carriage Return 
after the N; EDITOR returns the carriage, makes the 
substitutions, and prints the number of substitutions 
made, 3. 

Having abbreviated the word WASHINGTON, the 
user again prints his text: 

*/ 

87100 ALBUQUERQUE NEW MEX 

98310 BREMERTON WASH 

90241 DOWNEY CALIF 

98345 KEYPORT WASH 

87544 LOS ALAMOS NEW MEX 



94025 MENLO PARK CALIF 
95112 SAN JOSE CALIF 
98124 SEATTLE WASH 



He decides he has no more editing to do, so he 
saves his text on the file /ZIP/. Note that EDITOR 
responds with OLD FILE this time: 

* WRITE p 
TO /ZIP/ ? 

OLD FILE ? 
58 WORDS. 



QUIT and CONTINUE 



To leave EDITOR and return to the EXECUTIVE, 
the user types 

• QUIT ? 



out. If he does not call another language or a library 
program (or log out), he may return to EDITOR by 
typing the EXECUTIVE command 

-CONTINUE-, 



The EXECUTIVE dash indicates that he is no 
longer in EDITOR. At this point, he may call another 
language, do some work in the EXECUTIVE, or log 



and his text will still be in the text area. If EDITOR is 
recalled by typing EDITOR again, the text will no 
longer be there. 



CONVENTIONS FOR TYPING COMMANDS 



Any of the EDITOR commands may be shortened. 
For example, the APPEND command can be typed in 
any of the following ways: 

APPEND 

APPEN 

APPE 

APP 

AP 

A 

NOTE: TAPE and PUNCH can be abbreviated to no 
less than the first two letters. All other commands can 



be abbreviated to one letter. 

Spaces are not ignored when typing commands. 
For example, 

APP ENDp 

and 

A P 

result in a question mark. Spaces between the parts 

of a command form are allowed, however. Thus 

3 EDITp 

is legal. 



1 - If WAIT? is answered with a Y, EDITOR allows the user to make selective substitutions. See Repetitive Editing, Page 33. 



SUMMARY OF SECTION 1 



COMMAND SUMMARY 



The following EDITOR commands were introduced in this section: 



Command 


Command 




Type 


Name 


Command Function 


Input 


APPEND 


Enters text into text 


Commands 




area from terminal. 


Editing 


DELETE 


Deletes entire lines of 


Commands 




text. 




EDIT 


Allows edit of lines. 




SUBSTITUTE 


Allows substitution of 
characters throughout 
text. 


Output 


/ 


Prints text at termi- 


Commands 




nal. 




al 


Prints the line ad- 
dressed by a. 




WRITE 


Writes text on a file. 


Utility 


QUIT 


Returns to EXECU- 


Commands 




TIVE. 



SUMMARY OF CONTROL CHARACTERS 



The following control characters were introduced in this section: 



Control 
Character 


Function 


A c 


Deletes previous character in line 
being typed. 


Q c 


Deletes last line typed. 


D c 


During EDIT, copies rest of old line 
to new line and ends EDIT. Also 
used to terminate APPEND. 


E c 


Inserts text into old line. 


S c 


Deletes next character in old line. 


Z c and a 
character 


Copies old line to new line up to 
and including character typed after 
it. 



SECTION 2 
INPUT, OUTPUT, AND ADDRESSING OF TEXT 
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INPUT OF TEXT TO TEXT AREA 

Text may be entered into EDITOR'S text area from the terminal, from paper tape, or 
from a file. The following commands are used for these purposes: 



Type Of 




Command 


Input 


General Form Of Command 


Function 


Terminal 


APPEND ? 


Text typed on the terminal is 


Input 


text to be 
entered p 
D c 


brought into the text area. 


Paper 


TAPEp 


Text on the tape is brought 


Tape 


The user turns on the paper tape reader. 


into the text area and also 


Input 


When text is read, he turns the reader off 

and types 

D c 


printed on the terminal. 


Disk 


Long Form 


Short Form 


Text in the file is brought into 


READp 


READ file name^ 


File 
Input 


FROM: file name p 




the text area. 


aREADp 1 


aREAD file name p 


Text in the file is inserted into 




FROM: file name p 




the text area before the line 
addressed by a. 



The text entered into the text area by using 
APPEND, READ, or TAPE is always appended to any 
existing text; if the text area is empty, the text is 
simply brought into the text area. 

Example 

»/ 

THIS TEXT IS IN 

THE TEXT AREA. 

* APPEND p 

THIS TEXT IS p 

APPENDED. p 

D c 

*/ 

THIS TEXT IS IN 

THE TEXT AREA. 

THIS TEXT IS 

APPENDED. 



the Carriage Return, the user types as many lines of 
text as desired. The command is terminated with a 
Control D, which must immediately follow a Carriage 
Return. If D c is used anywhere else it will perform its 
editing function, instead of terminating the APPEND. 

Example 



* APPEND p 

THIS IS A LINE p 

THISD C IS A LINE 

D c 

»/ 

THIS IS A LINE 

THIS IS A LINE 



This D c copies the rest of 
the previous line, while the 
final D c terminates the 
APPEND. 



APPEND 



The command 
APPEND -, 



is used to enter text from the terminal. After typing 



NOTE: Many control characters are available for 
editing text during APPEND. See Use Of Control 
Characters During APPEND, INSERT, And CHANGE, 
Page 30. 

TAPE 

To enter text into EDITOR'S text area from paper 
tape, the command 



1 - a denotes the address of single line throughout this manual. 
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TAPE p 

is used. After typing the Carriage Return, the user 
turns on the paper tape reader. As the text on the 
tape is read, the text is printed on the terminal. When 
the tape has been read, the user turns off the paper 
tape reader and types a Control D unless there is a D c 
prepunched on the tape. 

Example 

* TAPE p After returning the carriage, the user turns 
26,4.3 on the paper tape reader. 

27,3.7 

35,9.0 

36,4.4 

40,5.1 

33,1.6 

35,2.0 

46,3.0 

54,3.2 

40,2.2 

47,28 

D c The user turns off the paper tape reader, 

• then types D c . 

No editing of text is allowed while the tape is 
being read. However, the control characters 

A c 
Q c 

w c 

|C 

will perform their usual editing functions if they are 
prepunched on the tape being read. 1 



Example 

* READ p 
FROM: /DATA/p 
130 WORDS. 

* 

The short form of the READ command is 

READ file name-) 

If this form were used, the previous example would 
look like this: 

» READ /DATA/ ? 
130 WORDS. 

• 

The above forms of READ simply append the text 
in the file to any existing text. To read text from a 
file and insert it before any line already in the text 
area, precede the READ command by the address of 
the line before which the text is to be inserted. 

Example 

*/ 

THIS TEXT IS IN 

THE TEXT AREA. 

* 'IN'READp 
FROM: /TEXT/p 
11 WORDS. 

*/ 

THIS TEXT IS READ These two lines were in the 

AND INSERTED. file /TEXT/. 

THIS TEXT IS IN 

THE TEXT AREA. 



READ and aREAD 

Both commands for entering text from a disk file 
have a long form and a short form. These forms are 
interchangeable. 

To enter text from a file, the user may type 

READ ? 

After the Carriage Return is typed, EDITOR re- 
sponds with 

FROM: 

The user now types the name of the file and then 
types a Carriage Return. EDITOR reads in the text 
and prints the number of words in the file. (3 charac- 
ters = 1 word). 



NOTE: The maximum amount of text that may be 
read with the form aREAD is 512 lines. If the user 
attempts to read more than 512 lines, the error 
message 

TOO MANY LINES 

will be printed. 

With all forms of the READ command, EDITOR 
will type a question mark if the file is not found in 
the user's directory. 2 

No editing can be done while the text is being read. 
The user must wait for EDITOR to print the asterisk 
before he begins editing. 

Using any form of READ does not erase the file 
being read. 



1 - See Terminal Input Editing, Page 23, for the functions of these control characters. 

2 - A file in another user's directory may be read if it has an @ in its name. For example, the file /@P/, in the directory with user 

name JONES and account number A4, may be read using the command READ (A4JONES)/@P/ -> 

Also, a public library program may be read using the command READ *UNISTA -\ 
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ORGANIZATION OF TEXT IN TEXT AREA 



Whether using APPEND, READ, or TAPE, any 
characters that can be typed on the Tymshare termi- 
nal will be accepted as text by EDITOR. However, 
this text must be organized according to certain prin- 
ciples which are discussed below. 

DEFINITION OF A LINE 

Text in the text area is divided into lines. EDITOR 
defines a line of text as any string of characters termi- 
nated by a Carriage Return. NOTE: A Carriage Return 
alone is considered to be a line. 

Example 

» APPEND p 

THIS IS A LINE ? 

SO IS THISp 

? 
D c 

• 1/ 

THIS IS A LINE 

•2/ 

SO IS THIS 

» 3/ Line 3 consists of a Carriage Return 

alone. 

* 

LINE CONTINUATION: 
THE LINE FEED 

A line of text may consist of more than one physi- 
cal line as it appears on the terminal. (On most termi- 
nals, the maximum physical line is 72 characters.) To 
enter a line consisting of more than one physical line, 
end each physical line with a Line Feed. 1 

Example 

» APPEND ? 
THIS IS^j, 
LINE ONE.-, 



LINE 


~l 


TWO. 


? 


D c 




• 1/ 




THIS 


IS 


LINE 


ONE 


• 2/ 




THIS 


IS 


LINE 




TWO. 





THIS IS 



T. 



LINE LENGTH 

The maximum allowable line length is 256 charac- 
ters, including blanks, Line Feeds, and the Carriage 
Return. If the user attempts to enter a line containing 
too many characters, the error message 

LINE TOO LONG 

will be printed. EDITOR will cut off the line by sup- 
plying a Carriage Return. 

SIZE OF TEXT AREA 

EDITOR'S large text area may contain up to 
60,000 characters. If the user attempts to enter more 
than this maximum number of characters, whether 
with APPEND, TAPE, or READ, the error message 

TOO MUCH TEXT 

will be printed. The command used will be termi- 
nated, and text entered up to that point will be re- 
tained in the text area. 

CAUTION: Since text read into EDITOR from 
paper tape is also printed at the terminal, if too much 
text is entered from paper tape the extra text will 
still be typed on the terminal after termination of the 
TAPE command. This means that EDITOR will try to 
interpret the extra text as commands; the most likely 
result is a series of question marks indicating that 
EDITOR does not recognize the "commands". 



LINE ADDRESSING 



Line addresses are used with many EDJTOR com- 
mands to specify the line or lines upon which the 
command is to operate. There are four basic kinds of 
line addresses; these may be used to build more com- 



plex addresses as will be shown below. 

To illustrate each type of line address, we assume 
that the following text, a data file containing payroll 
information, is in the text area: 



1 - See Appendix C, The Terminal, Page 66, for special conventions concerning Line Feeds and Carriage Returns when punching 
paper tape off line. 
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ADAMS, JOHN 

1.50 35.50 53.25 
BENTLEY, DICK 

2.75 40.00 110.00 
BROWN, JANE 

3.00 40.00 120.00 
BROWN, FRED 

1.75 38.25 66.94 
MEADOWS, BEY 

3.50 40.00 140.00 
SWAN, SIGMUND 

2.00 35.25 70.50 
UNDERWOOD, SAM 

3.00 40.00 120.00 
END 

BASIC LINE ADDRESSES 

1. The EDITOR Line Number 

EDITOR assigns a line number to each line of text 
in the text area; these are consecutive integers begin- 
ning with 1. 

Example 

• 2/ 

1.50 35.50 53.25 

» 

2. Any Text Within A Line 

Any line may be addressed by any text within the 
line, which must be surrounded by double quotes, 
single quotes, or square brackets, 1 at the user's option. 

Example 1 

• 'SIG7 

SWAN, SIGMUND 

• 

This line could also be addressed by any of the 
following: 

"SIG" 
[SIG] 
[AN, S] 

Example 2 

• [1.50]/ 

1.50 35.50 53.25 

If the text to be used as an address contains any of 
the characters ', ", [, or ] , the address may not be 
surrounded with that character. For example, if the 
line 

"JOHNSON" 1.50 



were in EDITOR'S text area, it could be addressed by 

'"JOHNSON"' 

or by 

["JOHN] 

but not by 

""JOHNSON" 

It could, of course, be addressed by "JOHNSON". 

3. Line Labels 

A line label is defined as a string of characters be- 
ginning with the first non-blank character in the line, 
and ending with a non-blank character having a space 
or Carriage Return immediately after it. A line label 
may not contain more than one consecutive blank. 

Any line may be addressed by a line label, sur- 
rounded by colons or angle brackets according to the 
following rules: 

• If the first non-blank character in the line is in 
print position 1, the line label may be sur- 
rounded by colons. 

Example 

*: BENTLEY,:/ 

BENTLEY, DICK 

*: MEADOWS, BEY:/ Two consecutive 

MEADOWS, BEY blanks in this label 

• : END:/ would be illegal. 

END 

• 

• If the line label is preceded by blanks, it must 
be surrounded by angle brackets « and ». 
These may also be used to surround labels not 
preceded by blanks, in place of colons. 

Example 

*<1.75>/ 

1.75 38.25 66.94 
« <3.50 40.00>/ 

3.50 40.00 140.00 
»<END>/ 
END 



The line label address is a faster means of address- 
ing than text within the line since EDITOR is not re- 
quired to search the entire line for the specified text. 

NOTE: A colon-surrounded line label may not 
contain a colon; an angle-bracketed line label may not 
contain an angle bracket. 



1 - On the terminal, [ is a shift K, and ] is a shift M. 
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4. Special Line Addresses: . And $ 

The last line in the text area may be addressed by 
a dollar sign. 

»$/ 
END 

• 

The period (.) is used to address the current line, 
the line which has been operated on most recently. 
EDITOR keeps track of the current line and redefines 
it with each use of a command. After the / command, 
the current line is the last line printed. Thus, since we 
just printed the last line in the text area, this line may 
be addressed by . as follows: 

»./ 
END 

• 

The position of the current line after each com- 
mand introduced thus far in this manual is given in 
the following table: 1 



This is now the current line. 



Immediately After: 


The Current Line 
(Addressed By .) Is: 


APPEND 


The last line appended (=$). 


DELETE 


Line preceding first line de- 
leted. 


EDIT 


The last line edited. 


READ 
aREAD 


The last line read (=$). 
The last line of text (=$). 


SUBSTITUTE 


The last line in which substi- 
tutions were made. 


TAPE 


The last line read from the 
tape (=$). 


WRITE 


The last line written on the 
file. 


/ 


The last line printed. 



The current line may be changed by typing a line 
address followed by a Carriage Return when EDITOR 
is awaiting a command. 

Example 

•./ 

BENTLEY, DICK This is line 3 in the text area. 

The location of the current line determines where 
EDITOR begins searching for a text or line label ad- 
dress; specifically, the search begins at the line follow- 
ing the current line. For example, since there are two 



lines with label BROWN, in our sample text, the fol- 
lowing may occur: 

*1/ 

ADAMS, JOHN 
»: BROWN,:/ 
BROWN, JANE 
» :BROWN,:/ 
BROWN, FRED 



Since EDITOR begins searching for the line label 
BROWN, at the line following the current line, it first 
prints the line BROWN, JANE. At this point, 
BROWN, JANE becomes the current line. Thus, 
typing :BROWN,:/ again causes EDITOR to print the 
line BROWN, FRED, since it starts searching for the 
label at the line following BROWN, JANE. NOTE : If 
EDITOR reaches the end of the text and still has not 
found a text or line label address, it will go back to 
the beginning of the text and continue its search until 
it either finds the address or reaches the point where 
it started searching. Thus, 



.1 



BROWN, FRED 
*: BROWN,:/ 
BROWN, JANE 



COMBINATION LINE ADDRESSES 

Combination line addresses may be formed by con- 
catenating basic addresses. They are useful when a 
single basic address does not uniquely define a line. 
For example, the line 

BROWN, FRED 

in the sample text may be addressed uniquely by 
"JA":BROWN,: as follows: 

* "JA": BROWN,:/ 
BROWN, FRED 



When EDITOR encounters this combination ad- 
dress, it first searches for a line containing JA. It be- 
gins its search for this line at the line following the 
current line. After a line containing JA is found, 
EDITOR searches for the next line after it which con- 
tains the line label BROWN,. A look at our sample 
text shows that this must be the line BROWN, FRED 
no matter where the search for JA begins, since only 
one line contains JA: 



1 - See Appendix B, Page 65, for a complete table of commands and their effects on the current line. 
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•/ 

ADAMS, JOHN 

1.50 35.50 53.25 
BENT LEY, DICK 

2.75 40.00 110.00 
BROWN, JANE 

3.00 40.00 120.00 
BROWN, FRED 

1.75 38.25 66.94 
MEADOWS, BEY 

3.50 40.00 140.00 
SWAN, SIGMUND 

2.00 35.25 70.50 
UNDERWOOD, SAM 

3.00 40.00 120.00 
END 



EDITOR first finds this 
line, containing the textJA. 
This is the next line after 
the line containing JA 
which contains the label 
BROWN,. 



ADDRESS ARITHMETIC 

Two arithmetic operators, + and -, may be used 
with a single address and an integer to specify a new 
address. The general form of such an address is 

a + n or a -n 

where a is any address except an EDITOR line num- 
ber and n is an integer. 

The meaning of such addresses is as follows: 

a + n Refers to the nth line after the line addressed 
by a. 

a-n Refers to the nth line before the line ad- 
dressed by a. 

Examples 

« "SIG"+2/ 
UNDERWOOD, SAM 



The general form of a combination address is 

where each a\ is a basic address. The address a x may 
be any basic address (line number, text, label, $, or .). 
However, a 2 through a n must be text addresses or 
line labels. The only limit on the number of addresses 
that may be concatenated is that the addresses plus 
the command may not contain more than 256 
characters. 

When it encounters any combination address, EDI- 
TOR first finds the line addressed by a t . It then 
searches for the first line after tinea! that is addressed 
by a 2 . It continues searching thus until a line ad- 
dressed by a n is found. 

As we have seen, if EDITOR reaches the end of 
the text and still has not found a text or line label ad- 
dress, it will go back to the beginning of the text and 
continue its search. Thus, the line 

BROWN, JANE 

could be addressed by 

<2.00>: BROWN,: 

To cause EDITOR to begin searching for a text or 
line label address at line 1, rather than at the line 
following the current line, a combination address be- 
ginning with $ may be used. 



•.+1EDIT 



3.00 40.00 120.00 
4.00 40.00 160.00 



$-1 DELETE p This command deletes the sec- 
ond to the last line of text 



ADDRESSING A RANGE OF LINES 

Most EDITOR commands may be used with the 
address of a range of lines to specify that the com- 
mand be executed for all lines in that range. 

The address of a range of lines takes the form 

*i.3f 

where a; is the address of the initial line in the range 
and af is the address of the final line in the range. 



Examples 
3,[SWAN]/ 

5,$DELETE ? 



Prints line 3 through the line con- 
taining the text SWAN. 

Deletes line 5 through the last line 
of text. 



The first address in the range must precede the sec- 
ond address. Thus, for example, 4,1/ is illegal. 



Example 
* $'40,007 

2.75 40.00 1.10 



Here, the first line after $ 
containing the text 40.00 
is printed. 



NOTE: If the first address in the range is a text or 
line label address, the current line is reset internally to 
the first line of the range when that address is found. 
Thus, the range consisting of the two lines 
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BENTLEY, DICK 

2.75 40.00 110.00 

could be addressed by 

'DICK',.+ 1 

since the current line is reset to the line containing 
DICK when the first address in the range is found. 

This fact is handy, since it saves the user from 
typing the text or line label address twice in specify- 
ing such ranges. (It is much easier to type 'DICK',.+1 
than 'DICK','DICK'+1.) However, caution is neces- 
sary. If the first address has the form 

a±n 

where a is a text or line label address, and n is an in- 



teger, the current tine will be reset to the line ad- 
dressed by a rather than the line addressed by a ± a 



Example 

* 'BEY'+2,.+5/ 
SWAN, SIGMUND 

2.00 35.25 70.50 
UNDERWOOD, SAM 

3.00 40.00 120.00 



This is line 'BEY'+2 



The current line was re- 
set to the line containing 
'BEY'; thus, the last line 
printed here is the line 
5 lines after the line con- 
taining BEY. 



OUTPUT OF TEXT FROM TEXT AREA 



Text in the text area may be printed at the termi- 
nal, punched on paper tape, or written on a disk file. 



The following output commands are available to the 
EDITOR user: 



Type Of 
Output 


General Form Of Command 


Command 
Function 


Terminal 
Output 


r/ 1 
1 


Prints the line or lines addressed by 
r. 

Prints the entire contents of the 
text area. 


/•PRINT p 
PRINT ? 


Prints the line or lines addressed by 
r in a page format. 

Prints entire contents of text area in 
a page format. 


t 


Prints the line addressed by .+1. 
Prints the line addressed by .-1. 


Paper 
Tape 
Output 


/•PUNCH p or /-PUNCH -^ 
PUNCH p or PUNCH -j 


Punches the line or lines addressed 
byr. 

Punches entire contents of text area. 


If the Carriage Return is used, EDITOR 
at the end of the text If the Line Feed i 
these. 


prints instructions and punches a D c 
s used EDI TOR does not do either of 


Disk 
File 
Output 


Long Form 


Short Form 


Writes the line or lines addressed by 
r to a file. Multiple blanks are com- 
pressed. 


/•WRITE p 
TO file name p 


/•WRITE file name p 


WRITER 

TO file name p 


WRITE file name p 


Writes entire contents of text area 
to a file. Multiple blanks are com- 
pressed. 


/•WRITE -^ 
TO file name p 

WRITE-], 

TO file name p 


Same as /-WRITEp except multiple 
blanks are not compressed. 

Same as WRITEp except multiple 
blanks are not compressed. 



1 ■ r denotes the address of a single line or a range of lines throughout this manual, unless otherwise specified. 
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TERMINAL OUTPUT 
The / Command 

This command has two forms: 

/ Prints the entire contents of the text area on the 
terminal. 

rl Prints the line or lines addressed by r on the 
terminal. 

Neither form of this command requires a Carriage 
Return after it. When the user types the /, EDITOR 
returns the carriage and prints the specified text. 

After the / command, the current line, addressed 
by ., is defined as the last line printed. Note that if 
ALT MODE or ESCAPE is used to interrupt the com- 
mand, the current line is not changed. 

Example 

*/ 

THIS IS ALL 

THE TEXT IN 

THE TEXT AREA. 

»./ 

THE TEXT AREA. 



The PRINT Command 

This command also prints text at the terminal. The 
difference between it and the / command is that the 
text is printed in a page format. 

Two forms are available: 

PRINT p Prints the entire contents of the text 
area. 

rPRINT p Prints the line or lines addressed by r. 

After the Carriage Return is typed, EDITOR re- 
sponds with 

DOUBLE SPACE? 

This question may be answered with a Y (for Yes, 
print the text with double spacing), or an N (for No, 
print the text with single spacing). 

After the user answers the question, EDITOR re- 
turns the carriage and prints the text in the PRINT 
format. 

The PRINT Format 

The format used by the PRINT command is de- 
signed so that the printout may easily be cut, have 
holes punched in it, and be placed in a notebook. As 



described above, the user may specify single or double 
spacing. He may also specify the number of lines per 
page, using the LINES command described below. 



If the LINES command has not been given, the 
PRINT command prints 56 lines on an 11 inch page, 
assuming single spacing. The following format is used: 

• After the Y or N response to the question 
DOUBLE SPACE?, EDITOR gives a series of 
Line Feeds to separate the command from the 
printed text. 

• EDITOR then types a line with four dashes, 

to serve as a guide for the paper cutter. 

• More Line Feeds are given to serve as the upper 
margin of the page. 

• The lines of text are printed. 

• More Line Feeds are given, to form the lower 
margin of the page. 

• Another line of four dashes is printed. If an- 
other page is needed, it is printed in the same 
format. Otherwise, EDITOR gives more Line 
Feeds and then prints the asterisk. 

After the PRINT command, the current line, ad- 
dressed by ., is the last line printed. 



The LINES Command 



This command sets the number of lines per page 
for the PRINT command. The general form of the 
command is 

LINES a? 2 

where n is the number of lines per page. 

If the command is not given, EDITOR assumes 56 
lines per page for PRINT. 

Once the command LINES n has been given, 
EDITOR assumes n lines per page every time PRINT 
is used, until another LINES command is given. If the 
user leaves EDITOR and returns by using CONTINUE, 
the last LINES command is still in effect since all in- 
formation is retained when CONTINUE is used. The 
last LINES command given is also in effect after the 
CLEAR command. 1 



The LINES command has no effect on the current 



line. 



1 - See Section 4, UTILITY COMMANDS, Page 47, for a complete description of CLEAR. 
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Example: LINES and PRINT 



« LINES 3 ? 
* PRINT ? 
DOUBLE SPACE? N 



A QUICK BROWN 
FOX JUMPS OVER 
THE LAZY DOG. 



PICKING JUST SIX QUINCES, NEW 
FARMHAND PROVES STRONG BUT LAZY. 



The Line Feed And t Commands 
If a Line Feed is given when EDITOR is awaiting a 
command, it prints the next line of text, that is, the 
line addressed by .+1 . 

Example 

*/ 

THIS IS LINE 1 
THIS IS LINE 2 
THIS IS LINE 3 

•1/ 



THIS IS LINE 1 
THIS IS LINE 2 



No Carriage Return is re- 
quired after the -j. 



Note that if the current line is the last line of text, 
the Line Feed command causes a ? to print. It will not 
go back to the beginning of the text and print the first 
line. 

Similarly, the t command prints the previous line, 
addressed by .-1 . 

Example 

*./ 

THIS IS LINE 2 

» f 

THIS IS LINE 1 



No Carriage Return is re- 
quired after the t, either. 



If the current line is the first line of text, the t 
causes a ? to print. After execution of either com- 
mand, the current line is the line printed. 

PAPER TAPE OUTPUT: 

THE PUNCH COMMAND 

This command punches text in the text area on 
paper tape. 

PUNCH may be used with or without the address 
of a line or a range of lines: 

PUNCH Punches the entire contents of the text 
area. 

rPUNCH Punches the line or lines addressed by r. 

In either case, the text is printed at the terminal as 
well as punched on paper tape. 

EDITOR punches header and trailer tape, 3 inches 
of each, when this command is used. 

Two options are available: 

Option 1. PUNCH 5 or rPUNCH p 

If the command is followed by a Carriage Return, 
EDITOR prints the instructions 

TURN PUNCH ON, TYPE CONTROL D. 
WHEN FINISHED, TURN PUNCH OFF, TYPE 

CONTROL D. 

After the user turns on the paper tape punch and 
types a Control D, EDITOR punches the header fol- 
lowed by the specified text. It then punches a Control 
D, and following that, the trailer. After EDITOR 
stops punching tape, the user must turn off the paper 
tape punch and then type a Control D to terminate 
the command. 

If the tape is subsequently read into EDITOR with 
the TAPE command, the Control D on the end of the 
tape will terminate the TAPE command. 
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Example 

»:THIS:,:ON:PUNCH ? 
TURN PUNCH ON, TYPE CONTROL D. 
WHEN FINISHED, TURN PUNCH OFF, TYPE 

CONTROL D. 
D c After turning on the paper tape punch, the 

user types a D c . 
THIS TEXT IS 
PUNCHED ON 
PAPER TAPE 
AND PRINTED 
ON THE TERMINAL 
D c The user turns off the punch, then types D c . 



Option 2. PUNCH -j or rPUNCH -j 

If PUNCH is followed by a Line Feed, no instruc- 
tions are given. EDITOR waits for the user to turn on 
the paper tape punch and type a Control D. EDITOR 
then punches the header, text, and trailer. It does not 
punch a Control D at the end of the text. After the 
trailer is punched, EDITOR waits for the user to turn 
off the paper tape punch and then type a Control D. 

After all variations of PUNCH, the current line, ad- 
dressed by ., is the last line punched. 

FILE OUTPUT: 
THE WRITE COMMAND 

The WRITE command is used to write text on a 
disk file. It may be used with or without the address 
of a line or range of lines: 

WRITE Writes the entire contents of the text area 
on a file. 

rWRITE Writes the line or lines addressed by ron 

a file. 

There are two options: 

Option 1. WRITE p or /-WRITE ^: 
Multiple Blank Compression 

When the WRITE command is followed by a Car- 
riage Return, the text is written on a file with multi- 
ple blanks compressed. This means that EDITOR ab- 
breviates any string of multiple blanks, so that the file 
will use less space on the disk. The Tymshare lan- 
guages, CAL, SUPER BASIC, etc., will accept pro- 
grams written on files with the WRITE^ command. 

This command has a long form and a short form, 
like the READ command. The long form works as 
follows: 



After the Carriage Return is typed, EDITOR re- 
sponds with 

TO 

The user then types the file name followed by a Car- 
riage Return. (Rules for naming files are discussed 
on Page 21.) 

If the user has not previously created a file with 
this name, EDITOR responds with 

NEW FILE 

If the user has a file with the chosen name in his 
directory, EDITOR responds with 

OLD FILE 

In either case, the user may confirm the command 
by typing a Carriage Return, or abort it by typing 
ALT MODE or ESCAPE. If he confirms the com- 
mand, EDITOR will print the number of words writ- 
ten on the file. 

Example 

* WRITE ? 
TO /PAY/p 

OLD FILE e The command is aborted. No 

* WRITE -) new text is written on /PA Y/. 
TO /NPAY/ ? 

N EW F I LE -) This command is confirmed. 
252 WORDS. There are 252 words in the file 

» /NPAY/. 

NOTE: If a Carriage Return is typed after OLD 
FILE, whatever was previously on the file will be re- 
placed by the new text. 

A short form of the WRITE^ command is avail- 
able. The user may just type 

WRITE file name ^ 

Example 

•WRITE /Q/ ? 
NEW FILEp 
73 WORDS. 



Option 2. WRITE -j or rWRITE -;: 
No Blank Compression 

Although the Tymshare languages handle programs 
written on files with multiple blanks compressed, 
command files will not always work properly if they 
are written with multiple blanks compressed. The 
WRITE command should be followed by a Line Feed 
when writing command files in EDITOR. This form 
of WRITE writes files with blanks uncompressed. 
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Example 



•APPEND 
SBASIC -> 



The user creates a command file in 
EDITOR. 



LOAD /PROG/ p 



RUN ^ 
PRINT ' 
QUITp 

D c 



END OF JOB" 



* WRITE -j, When WRITE-^ is used, EDITOR 

TO /COMSB/-) does not print the number of words 



NEW FILE ^ in the file. 



NOTE: The WRITE-^ command does not have a 
short form. 



After all forms of the WRITE command, the cur- 
rent line, addressed by ., is the last line written on the 
file. 

Using any form of WRITE does not erase the text 
from the text area. 



RULES FOR NAMING FILES 

EDITOR will accept all the file names allowed by 
the Tymshare EXECUTIVE. 

1. A file name may begin and end with a slash. In- 
side the slashes it may contain any characters 
except a slash. 

Examples 

* READ l@ZM 5 
•WRITE /G c ;/;p 

2. A file name may begin and end with single 
quotes. Inside the quotes, it may contain any 
characters except a single quote. For example, 

• WRITE p 

TO '@ PROGRAM 4' 5 

3. File names need not be protected by slashes or 
quotes. Files which are not thus protected may 
contain only the following characters: 

A through Z 

through 9 

@ 
Example 

•WRITE -j 
TO @DATA2 5 
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SECTION 3 
EDITING TEXT IN TEXT AREA 

EDITOR has three kinds of commands available for editing text in the text area: 





Manipulating 




Editing Text 


Whole Lines Or 


Repetitive 


Within A Line 


Groups Of Lines 


Editing 


EDIT 


COPY 


FIND 


MODIFY 


CHANGE 
DELETE 
INSERT 
MOVE 


SUBSTITUTE 



In addition, there are 25 editing control characters A c - K c and M c - Z c which may be 
used for editing during many commands as well as for editing terminal input. These con- 
trol characters perform such functions as copying from one line to another, deleting char- 
acters in a line, and inserting characters into a line. 



TERMINAL INPUT EDITING 



Whenever characters are being typed into EDITOR 
from the terminal, the control characters A c , Q c , W c , 
and l c may be used. Thus, these control characters 
may be used in any of the following situations: 

1. When typing commands. 

Example 

» APPEMA C HMD p The A c deletes the preceding 
character, M. 

NOTE: There is one exception to this rule; file 
names may not be edited. Thus, if an error is made 
while typing the file name during READ or WRITE, 
press the AL T MODE or ESCAPE key and retype the 
entire command. 

2. When typing text during APPEND, INSERT, and 
CHANGE. 1 

Example 

• APPEND p 

FOURCORE AND SEVEN YEARS AGOQ c t 

The Q° deletes the entire line being typed 
and returns the carriage; the user then 
types the correct line. 

FOURSCORE AND SEVEN YEARS AGO p 



3. When typing the new line during EDIT and 
MODIFY. 

Example 

*2 EDITp 

OUR FATHERS FORTH 

OUR FATHERS BOUGHTW c \BROUGHT FORTHp 

The W° deletes the preceding word in the 

line being typed. 
»./ 

OUR FATHERS BROUGHT FORTH 
• 

4. When using the TAPE command. 

Although no editing may be done while the tape is 
being read, A c , Q c , \N°. and l c will be accepted by 
EDITOR'S TAPE command if they have been pre- 
punched on the tape being read. 

CONTROL A: DELETING 
THE PRECEDING CHARACTER 

This control character deletes the immediately pre- 
ceding character; EDITOR prints a back arrow («-) to 
indicate its use. It may be used repeatedly to delete 



1 - See Page 32 for a description of INSERT and CHANGE. The form of these commands is similar to that of APPEND; the con- 
trol characters discussed here work the same way during INSERT and CHANGE as they do during APPEND. 
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more than one preceding character up to and including 
the first character in the line being typed. It will not 
delete characters in preceding lines. 1 

Example 

« APPEND p 

THIS IX TA c «-A c «-A c -e-S TEXT ? 

The first A c deletes the T; the second, the 
space; the third, the X. The rest of the 
line is retyped correctly. 

D c 

../ 

THIS IS TEXT 



CONTROL W: DELETING 
THE PRECEDING WORD 

This control character deletes the preceding word 
in the line being typed. The preceding word is defined 
as including: 

• The immediately preceding blanks, if any, plus 

• The immediately preceding non-blank charac- 
ters, up to but not including the first blank pre- 
ceding them. 

EDITOR prints a back slash (\) when a Control W 
is used. 



CONTROL Q: DELETING 
THE PRECEDING LINE 

Control Q deletes the entire line being typed. 
EDITOR prints an up arrow (t) to indicate its use, 
and returns the carriage for the user. 

Example 
»:12:EDIT ? 

12 24.36 89 32 

13 24.19 32Q c t 
13 34.19 32 p 
*./ 

13 34.19 32 
* 

When typing text during APPEND, INSERT, and 
CHANGE, Control Q may be used to delete several 
lines of text, up to and including the first line of text 
typed during the command. 

Example 

* APPEND p 
CONTROL Q WILLp 
DELETE MORE THAN ? 
ONE LINEp 
DURING APPEND ? 
INSERT, ANDp 
CHANGEQ c t 

QCf 

Q c t 

DC 

•/ 

CONTROL Q WILL 

DELETE MORE THAN 

ONE LINE 



Exampl 


e 




APPEND 2 




ONE 


TWOWCYTHREEp 




TWO 


GOUR W c \FOUR ? 


Note that the two 


D c 




spaces following 


»/ 




GOUR are deleted, 


ONE 


THREE 


but the three spaces 


TWO 


FOUR 


preceding the word 
are not. 



Control W may be used repeatedly to delete more 
than one word in the line, up to and including the 
first word in the line. It may not be used to delete 
words in preceding lines. 



CONTROL I: TABS 

Control I is used to space to the next tab stop. 
EDITOR automatically initializes 10 tab stops, at 
print positions 8, 16, 32, 40, 45, 50, 55, 60, 65, and 
70. These may be changed with the TABS command 
(see Section 4). 

Example 

* APPEND ? 

1 2345678901 2345678901 2345678901 234567890 p 

|C f|C |l c tl c t ? 

D c 

*/ 

1 234567890 1 2345678901 2345678901 234567890 

t t ft 

* 

In this example, the user appended a line of forty 
digits. In the next line, he typed l c ; EDITOR re- 
sponded by spacing to the first tab stop at print posi- 
tion 8. The user typed an up arrow to mark the spot, 
and continued typing l c followed by t until he 
reached the tab stop at print position 40. 



1 - It is not usually a good idea to use A during EDIT and MODI FY; see Control N, Page 29. 
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EDITING TEXT WITHIN A LINE 



THE EDIT AND 
MODIFY COMMANDS 

The EDIT and MODIFY commands are used to 
make changes in individual lines of text that are in the 
text area. The following forms of these commands are 
available: 



'EDIT p 
/■MODIFY p 

EDIT-^ 
MODIFY -j, 

EDITt 
MODIFYt 



Allow edit of the line or lines ad- 
dressed by r. 

Allow edit of the next line, ad- 
dressed by .+1. 

Allow edit of the previous line, ad- 
dressed by .-1. 

Editing A Single Line 

When an EDIT or MODIFY command is given with 
the address of a single line, the line addressed is made 
available for editing. This line is called the old line; it 
is the line printed on the terminal when the EDIT 
command is used. MODIFY is the same as EDIT ex- 
cept that it does not print the old line. 

After the EDIT or MODIFY command is given 
(and the old line is typed, with EDIT), the user may 
type the line which is to replace the old line, called 
the new line, followed by a Carriage Return. The Car- 
riage Return terminates the new line and the EDIT or 
MODIFY command, and the new line replaces the old 
line in the text area. 

Example 

*:SMITH,:EDITp 

SMITH, JOHN 1.50 EDITOR printsthe old line. 

SMITH, JOHN 2.00 p The user types the new line. 

*.l 

SMITH, JOHN 2.00 The new line has replaced 

* the old line in the text area. 

The next example shows the same editing done 
with MODIFY. The only difference is that the old 
line is not printed. 

« :SMITH,: MODIFY p 

SMITH, JOHN 2.00 p 

«./ 

SMITH, JOHN 2.00 



This is the new line. 



and .-1 MODIFY, respectively. It is unnecessary to 
type a Carriage Return after the Line Feed or up 
arrow. 

Editing A Range Of Lines 

If EDIT is used with the addressof a range of lines, 
EDITOR prints the specified lines one at a time. After 
printing an old line, it waits for the user to edit it, and 
then prints the next line in the range, continuing thus 
until all lines in the range have been edited. 

Example 

♦ / 

LINE 4 
LINE 5 
LINE 6 
»1,3EDITp 
LINE 4 
LINE 1p 
LINE 5 
LINE 2-, 



LINE 


6 


LINE 


3 ? 


»/ 




LINE 


1 


LINE 


2 


LINE 


3 



The forms EDIT-jand MODIFY-jare equivalent to 
.+1 EDIT and .+1 MODIFY, respectively. Similarly, 
EDIT t and MODIFY t are equivalent to .-1 EDIT 



MODIFY used with the address of a range of lines 
works the same way, except that the old lines are not 
printed. 

The current line, addressed by ., is defined as the 
last line edited after all forms of EDIT and MODIFY. 
NOTE: This implies that successive lines of text may 
be edited by using EDI T-^or MODIF Y-^ repeatedly. 

CONTROL CHARACTERS USED 
WITH EDIT AND MODIFY 

In addition to the control characters A c , Q c , W c , 
and l c discussed under Terminal Input Editing, there 
are many more control characters which may be used 
during EDIT and MODIFY. 1 These characters all per- 
form some sort of editing operation on the old line to 
form the new line. For example, some of them copy 
characters from the old line to the new line. 

In the following discussion of control characters 
used with EDIT and MODIFY, the control characters 



These additional control characters may also be used during APPEND, INSERT, and CHANGE; see Use Of Control Characters 
During APPEND, INSERT, And CHANGE, Page 30. 
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are classified according to the functions they perform. 
Some of these control characters also terminate the 
edit; this will be noted under the description of the 
character. 



Control Characters Used For Deleting 



Example 

»:STOCKS:EDITp 

STOCKS ASTRODATA 1399 

P c A%%%%%%%%%%D c ASTRODATA 

»./ 

ASTRODATA 1399 



1399 



Control S 

Control S deletes the next character in the old line. 
EDITOR prints a percent sign (%) to indicate that a 
Control S was used. 

Example 



» 'AMER'EDIT ? 
AMERICAN TEL & TEL 

Z C 6AMERICAN TEL & TEL 

AMERICAN TEL & TEL 



256,960 This is the 
old line. 

256S C %960 p 



256960 



This is the 
new line. 



In this example, Control Z copies characters from 
the old line to the new line up to and including the 
character typed after it, 6. At this point, the next 
character in the old line is a comma, which the user 
wishes to delete. He types a Control S and EDITOR 
prints a %. The comma is now deleted. The user then 
types the rest of the new line and terminates the edit 
with a Carriage Return. 

Control K 

This control character deletes the next character 
in the old line and prints the character it deletes. Thus, 
it performs exactly the same function as Control S; 
the only difference between Control K and Control S 
is that EDITOR prints the character deleted instead of 
printing a %. Thus, Control K could have been used in 
the above example to delete the comma, as follows: 

« 'AMER'EDIT -> 



AMERICAN TEL & TEL 
Z C 6AMERICAN TEL & TEL 

AMERICAN TEL & TEL 



256,960 

256K C ,960 p 

256960 



Control P 

Control P deletes characters from the old line up 
to but not including the character typed after it. 
EDITOR prints a percent sign for each character it 
deletes. 



Here the user wishes to delete the word STOCKS 
as well as the four blanks following it; in other words, 
he wants the new line to begin with the word ASTRO- 
DATA. He types Control P followed by the character 
A, telling EDITOR to delete the characters up to but 
not including the first A it encounters. EDITOR 
prints a % for each character deleted. The user then 
types a Control D to copy the rest of the old line to 
the new line and end the edit. 



Control X 

Control X deletes characters from the old line up 
to and including the character typed after it. Again a 
% is printed for each character deleted. 



Example 

•EDIT -j 

CANOGA ELECTRONICS 



Z c SCANOGA ELECTRONICS 



SHARES OUT 
STANDING=511 

X°=%%%%%%% 



%%%%%%%%%%%%51 1 



•./ 

CANOGA ELECTRONICS 



511 



In this example, the user types Z C S to copy char- 
acters from the old line to the new line up to and in- 
cluding the character S. He then types five blanks to 
make sure that the new line contains appropriate 
spacing, and types a Control X followed by an equal 
sign to delete the characters up to and including the 
equal sign. Then he types the rest of the line, termi- 
nating the edit with a Carriage Return. 



Control Characters Used For Copying 

There are 10 control characters used for copying 
from the old line to the new line. C c , O c , Z c , and U c 
simply copy characters; D c and F c copy the rest of 
the old line and end the edit; and H c , R c , T , and Y c 
copy the rest of the old line and continue the edit, 
either at the end of the old line (H c ) or at some point 
in the new line (R c , T c , and Y c ). 
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Control C 

Control C copies the next character in the old line; 
it may be used repeatedly to copy more than one 
character. 

Example 

»8EDIT ? 

COLINS RADIO 2899 

C c CC c OE c <LE c >D c LINS RADIO 



2899 



COLLINS RADIO 



2899 



In this example, the user wishes to correct a spell- 
ing error, where an L was left out of COLLINS. He 
copies the C and using Control C twice and then 
uses Control E to insert an L. A Control D copies the 
rest of the old line and ends the edit. 

Control O 

Like Control X, P, and Z, Control may be fol- 
lowed by any character. It copies up to but not in- 
cluding the character typed after it. 

Example 

» 'STOCK'EDIT p 

CONDUCTRON STOCKS 2536 

O c CONDUCTRONX c K%%%%%%S°%D c 2536 

»./ 

CONDUCTRON 2536 

• 

In the above edit, the user deletes the word 
STOCKS (and the space preceding it) from the old 
line. He first copies up to but not including the first 
space in the line by typing Control followed by a 
space. He then deletes the characters up to and in- 
cluding the K with X C K, and deletes the final S in 
STOCKS with Control S. The edit is completed with 
a Control D. 

Control Z 

Control Z copies up to and including the character 
typed after it. The line edited in the previous example 
could also be edited using Control Z as follows: 

• 'STOCK'EDIT p 

CONDUCTRON STOCKS 2536 

Z c CONDUCTRON X c %%%%%%%D C 2536 

»./ 

CONDUCTRON 2536 

• 

Since he types a Control Z followed by a space, the 
user has copied the first word in the line plus the 



space after it. Since he wishes to preserve five spaces 
between the name of the company and the number 
following it, he uses X c followed by a space to delete 
the word STOCKS and the space immediately follow- 
ing it. The D c completes the edit. 

Control U 

This control character copies characters from the 
old line to the new line up to but not including the 
character at the next tab stop. 1 

Example 

«.EDIT ? 
1234567890 
U c 1 234567 p 
»./ 
1234567 



Since the first tab stop is at print position 8, the 
Control U in this example copies the first 7 characters 
in the line. 

NOTE: If the next tab stop is at a print position 
beyond the last character in the old line. Control U 
effectively ends the edit since it copies the Carriage 
Return. Thus, if another Control U were typed in the 
above example, the following would occur: 

*.EDIT^> 

1234567890 

U C 1234567U C 890 



Control D 

Control D copies the rest of the old line to the new 
line, printing it, and ends the edit. 

Example 
*:CORP.:EDIT 



7> 
CORP. 4210 

E C <DYNAMICS EC>D c CORP. 



4210 



DYNAMICS CORP. 



4210 



Control F 

Like Control D, Control F copies the rest of the 
old line to the new line and ends the edit; however, it 
does not print the characters copied. Thus, using Con- 
trol F instead of Control D in the above example 
would yield the following: 



1 - Unless the TABS command (see Page 47) has been given, EDITOR assumes tab stops at print positions 8, 16, 32, 40, 45, 50, 
55, 60, 65, and 70. 
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• iCORP.iEDITp 

CORP. 4210 

E C <DYNAMICS E°>F C 

*./ 

DYNAMICS CORP. 4210 



Control H 

Control H copies the rest of the old line to the new 
line and prints it. It does not end the edit; thus, edit- 
ing may continue at the end of the line. 

Example 

• [SPECIAL] MODIFY p 

H c ELECTRONIC SPECIALTY 1648 ? 

»./ 

ELECTRONIC SPECIALTY 1648 

» 

In this example, the MODIFY command is used in- 
stead of the EDIT command, so that the old line is 
not printed. The H c copies the rest of the old line, 
which happens to be the entire old line in this case. 
The edit continues at the end of the line, where the 
user adds an 8 to the line and terminates the edit with 
a Carriage Return. 

Control R 

Control R gives a Line Feed without returning the 
carriage, copies the rest of the old line, and then re- 
turns the carriage and copies the new line up to the 
point where the Control R was typed. The edit con- 
tinues at this point in the new line. Thus, Control R is 
especially useful when a great deal of editing has been 
done and the user wishes to see what the new line 
looks like thus far. 

Example 

»<LINCH>EDIT ? 

LINCH SYSTEMS 722 

P°L %%%%LTN C -HJN C *-YNCH R c 

SYSTEMS 722 

LYNCH 

The first editing the user wishes to do in the above 
example is to delete the four spaces preceding the 
word LINCH, and change the I in LINCH to a Y. The 
P C L deletes the four spaces. The user then types an L, 
but makes two typing errors when trying to type a Y. 
He uses Control N to backspace over these errors (see 
Control N below). After he finally types the YNCH, 
he decides to use Control R to see exactly what he has 
done to the new line. The R c gives a Line Feed, types 



the rest of the old line, gives a Carriage Return, and 
types the new line up to the point where the R c was 
typed. The user is positioned at the end of the word 
LYNCH and may continue the edit from this point. 

Note that the Control R does not align the old and 
new lines. The following control character. Control T, 
will do this, although it is thus a little slower than 
Control R. 

Control T 

Control T is identical to Control R, except that it 
aligns the old and new lines, thus typing them in a 
more readable format. Control T copies the rest of the 
old line plus the new line up to the point where the 
Control T was typed, aligning the old and new lines, 
and continues the edit at this point. Thus, using Con- 
trol T instead of Control R in the above would yield 
the following: 

*<LINCH>EDIT p 

LINCH SYSTEMS 722 

P C L%%%%LTN C -HJN C +-YNCHT C 
SYSTEMS 722 

LYNCH 

The user may now continue editing with the rest of 
the old line printed directly above the point at which 
he types the new line. 

Control Y 

Control Y copies but does not print the rest of the 
old line, and continues the edit at the beginning of the 
new line, with the new line used as the old line. It is 
useful when the user has done some editing in the line, 
and wishes to make a change earlier in the line with- 
out losing the editing he has done already, as he 
would if he used Control Q to restart the edit. 

Example 

» 1/VATKINS'EDIT ? 

WATKINS JOHNSON 2731 

Z C 2WATKINS JOHNSON 26Y C 

Z C SWATKINS-F C 

*./ 

WATKINS-JOHNSON 2631 

* 

The user copies up to and including the 2 with 
Z c 2; then types a 6 to replace the 7 in the old line. At 
this point, he realizes that he has forgotten to type a 
dash between WATKINS and JOHNSON, so he uses 
Control Y to copy the rest of the old line and contin- 
ue the edit at the beginning of the new line. Note that 
the rest of the old line does not print on the terminal. 
The user now copies out to the S with Z C S, types a — , 
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and copies the rest of the old line and ends the edit 
with F c . Note that F c copies the edited line rather 
than the original old line. 

Inserting Characters Into A Line: 
Control E 

Control E inserts text into the old line. When text 
is to be inserted, a Control E is typed first; EDITOR 
prints a <. Then the text to be inserted is typed; this 
is followed by a second E c . This time, EDITOR prints 
a>. 

Example 

« T/VESTERN'EDIT ? 

WESTERNUNION * 7527 

ZCNWESTERNE^ E C >F C 

♦./ 

WESTERN UNION 7527 



In this example, Control E is used to insert a space 
between the words WESTERN and UNION. 



from the old line when using Control A. The follow- 
ing two examples clarify this difference between Con- 
trol A and Control N : 

*: DATA: EDIT ? 

DATA TREMD 471 

Z C EDATA TRE.NC+HMDCD 471 

»./ 

DATA TREND 471 



When attempting to change the M to an N, the user 
mistakenly types a comma, which replaces the M in 
the old line. The next character in the old line is now 
the D. Since he wishes to replace the M rather than 
the D, he must backspace in the old line and the new 
line with Control N. If he uses Control A instead, he 
will lose a character, as follows: 

*: DATA: EDIT p 

DATA TREMD 471 

Z C EDATA TRE,A C -HMD C 471 

»./ 

DATA TREN 471 



Other Control Characters 

Control N: Backspacing 

Control N backspaces one character in both the 
old and the new lines. EDITOR prints a back arrow 
(*-) when Control N is used. 

».EDITp 

BBCDEF 

NOPN c -HM c -HM c +-AD c BCDEF 

»./ 

ABCDEF 

* 

In this example, the user types the characters NOP 
in the new line. He then uses Control N three times to 
backspace over these characters. Since Control N 
backspaces in the old line as well as the new line, he is 
now positioned at the beginning of the old line. He 
types an A, to replace the first B in the old line. Now 
he is positioned at the second character in the old line. 
Thus, the rest of the old line consists of the characters 
BCDEF. Control D copies these characters from the 
old line to the new line and ends the edit. 

► NOTE: During EDIT and MODIFY, it is usually 
better to delete characters in the new line by back- 
spacing over them with Control N, rather than using 
Control A. Since Control A does not backspace in the 
old line, it is very easy to lose characters accidentally 



Typing a Control A does not change the position in 
the old line. Thus, when the N is typed, it replaces 
the D in the old line. Then a Control D copies the rest 
of the old line, which consists of the characters from 
the blank following the D through the 1 . 

Control Q: Restarting The Edit 

We have already discussed Control Q under Termi- 
nal Input Editing; however, we should mention here 
that when it is used during EDIT and MODIFY, it not 
only deletes the new line but also restarts the edit at 
the beginning of the old line. Thus, it is equivalent to 
using Control N repeatedly to delete the entire new 
line, rather than using Control A to do this. 

NOTE: Control W works like Control A during 
EDIT and MODIFY in that it does not back up in the 
old line. 

Control M and Control J 

Control M and Control J are equivalent to the Car- 
riage Return and Line Feed, respectively. They may 
be used any time a Carriage Return or Line Feed is 
desired during any EDITOR command. 



The Carriage Return 
During EDIT And MODIFY 

During EDIT and MODIFY, the Carriage Return 
terminates the new line and the edit. 
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Example 

. 1EDIT p 

LIST OF STOCKS 

Z c TLISTp 

»./ 

LIST 



USE OF CONTROL CHARACTERS 
DURING APPEND, 
INSERT, AND CHANGE 

All the control characters which may be used 
during EDIT and MODIFY may also be used during 
APPEND, INSERT, and CHANGE. 1 In essence, most 
of them work the same way they do during EDIT and 
MODIFY. However, because of the way the old and 
new lines are defined during APPEND, INSERT, and 
CHANGE, the result of using control characters which 
operate on the old line is somewhat different during 
these commands. 

During APPEND, INSERT, and CHANGE, the old 
line is defined as the line immediately preceding the 
line being typed, while the new line is defined as the 
line being typed. This means that BOTH the new and 
the old lines will be placed in the text area. The new 
line does not replace the old line in the text area as it 
does during EDIT and MODIFY. 

Example 

♦ APPEND ? 

1,0,0,1,0,0 p 

F c 

F c 

D c 

•/ 

1,0,0,1,0,0 

1,0,0,1,0,0 

1,0,0,1,0,0 

» 

Note that Control F copies the rest of the old line 
without printing it and terminates the new line, 
whereas Control D does not copy anything in the 
above example; it merely terminates the command. 

Control D During APPEND, 
INSERT, And CHANGE 

During APPEND, INSERT, and CHANGE, Control 
D may either terminate the command, as in the above 
example, or it may copy the rest of the old line to the 



The first two D c 's copy the rest of 
the old line to the new line and 
terminate the new line. 

The final D c terminates the AP- 
PEND. 



new line and terminate the new line. Which of these 
actions it performs depends on where it is typed. 

• If it is typed immediately after a Carriage Re- 
turn, it terminates the command. 

• Otherwise, it copies the rest of the old line to 
the new line, prints it, and terminates the new 
line with a Carriage Return. 

Example 

* APPEND p 
1,0,0,0,0 p 
0,1,D C 0,0,0 
O.O.I.D^O 

D c 

»/ 

1,0,0,0,0 

0,1,0,0,0 

0,0,1,0,0 

• 

Control D is the only control character which has 
a slightly different function during APPEND, IN- 
SERT, and CHANGE; all other control characters per- 
form the same functions as they do during EDIT and 
MODIFY. As long as the difference in the definitions 
of old line and new line is kept in mind, there should 
be no trouble understanding most of the control char- 
acters. There are a few; namely, Y c , R c , and T c , 
whose functions during APPEND, INSERT, and 
CHANGE are not obvious. These are discussed below. 

Control Y During APPEND, 
INSERT, And CHANGE 

During these commands. Control Y copies the rest 
of the old line to the new line, returns the carriage, 
and then allows an edit of the new line. Only one line 
is added to the text being typed, no matter how many 
times Control Y is used before terminating the new 
line. 

Example 

* APPEND p 
1,0,0,2,0,0 p 

3,1, 2, Y c The Y c copies the 2,0,0 and allows an 

2D C ,1 ,2,2,0,0 edit of line 2. 

D c 

•/ 

1 ,0,0,2,0,0 Note that only two lines are appended. 

2,1,2,2,0,0 

# 

To see the difference between Y c and other con- 
trol characters that copy the rest of the old line, con- 



INSERT and CHANGE are discussed on Page 32. Syntactically, they are similar to APPEND. The control characters discussed 
here work the same way during INSERT and CHANGE as they do during APPEND. 
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sider what happens if Control F is used instead of 
Control Y in the above example: 

• APPEND p 
1,0,0,2,0,0 p 
3,1,2,FC 
2D<M,2,2,0,0 
D c 

* I 

1,0,0,2,0,0 
3,1,2,2,0,0 
2,1,2,2,0,0 



The F c copies the 2,0,0 and ends 
the new line. 



Here, three lines are appended. 



CAUTION: When using Control Y to allow editing 
of the new line, it is very easy to forget that it also 
copies the rest of the old line. If the old line is longer 
than the new line, unwanted text may accidentally be 
added to the text area, as in this example: 



» APPEND p 
500 


1.95 


40 78.00 ? 


FRAMER, FREDY C 


The user wanted to correct an 


FARF C 




error at the beginning of the 


D c 




new line. He forgot about the 


»/ 




old line! 


500 


1.95 


40 78.00 


FARMER, FRED.95 


40 78.00 



Control R And T During 
APPEND, INSERT, And CHANGE 



During these commands. Control R copies the rest 
of the old line plus the new line up to the point where 
the R c was typed, and allows the user to continue 
typing the new line at this point, using control char- 
acters if desired. Control T is the same as Control R 
except that it aligns the old and new lines. Like Con- 
trol Y, these characters may be used as many times as 
desired before terminating the new line, and only one 
new line will be added to the text being typed. 



Example 



• APPEND ? 

HICKORY DICKORY DOCKp 

THE MOUSE TN<*-RAN UP THHN^E CLT C 

OCK 
THE MOUSE RAN UP THE CLF C 
D c 
*/ 

HICKORY DICKORY DOCK 

THE MOUSE RAN UP THE CLOCK 



MANIPULATION OF WHOLE LINES AND GROUPS OF LINES 



In addition to editing text within a line, the 
EDITOR user may delete whole lines of text, insert 
lines of text, change lines, copy lines, and move lines 
to a different position in the text. The commands to 
manipulate whole lines and groups of lines are very 
easy to remember since they are all descriptive of the 
functions they perform. They are: 

DELETE 

INSERT 

CHANGE 

COPY 

MOVE 

THE DELETE COMMAND 

This command has the general form 
rDELETE ? 

where r is the address of a single line or a range of 
lines. The command deletes the line or lines addressed 
by r. 



Example 

•/ 

THESE LINES WILL 

BE DELETED. 

THESE LINES WILL 

REMAIN IN THE TEXT AREA. 

* 1,2 DELETE ? 

*/ 

THESE LINES WILL 

REMAIN IN THE TEXT AREA. 

» 

Note that each time the DELETE command is 
used, EDITOR reassigns line numbers. EDITOR line 
numbers are always consecutive integers beginning 
with 1; thus, in the above example, lines 3 and 4 be- 
come lines 1 and 2 after the original lines numbered 1 
and 2 are deleted. 

The DELETE command may also be used with a 
Line Feed to delete the next line. Thus, DELETE-jis 
equivalent to .+1 DELETE. 
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After the DELETE command, the current line, ad- 
dressed by ., is the line preceding the first line deleted. 
If the first line of text is deleted, the current line is 
simply the first line of text remaining in the text area. 

The DELETE command may be used to delete all 
lines of text in the text area by typing 

1,$DELETE ? 

However, this may also be accomplished with the 
CLEAR command, see Page 47. 



THE INSERT COMMAND 

The general form of this command is 

aINSERTp 
text to be 
inserted jp 
D c 

where a is the address of a single line. The text typed 
during the command is inserted into the text area be- 
fore the line addressed by a. The user may type as 
many lines of text as desired before terminating the 
command with a Control D. The terminating D c must 
follow a Carriage Return. 

All of the editing control characters that may be 
used with APPEND may be used with INSERT; they 
work the same way during INSERT as they do during 
APPEND. 1 

Example 

♦/ 

NOW IS THE TIME 

OF THEIR PARTY. 

•SlNSERTp 

FOR ALL GOOD MEN ? 

TO CIA c *-OME TO THE AID ? 

D c 



»/ 

NOW IS THE TIME 
FOR ALL GOOD MEN 
TO COME TO THE AID 
OF THEIR PARTY. 



Note that the text is in- 
serted before the line 
addressed by $. 



THE CHANGE COMMAND 

This command has the general form 

/-CHANGE ^ 
lines of text 
to replace the 
lines addressed 
by rp 
D c 

It is used to replace a line or a range of lines al- 
ready in the text area (addressed by r) with the line or 
lines typed during the command. 

The number of lines in the range r need not be the 
same as the number of lines typed to replace them. 
Thus, for example, the CHANGE command may be 
used to replace 1 line with 3 lines, or to replace 1 1 
lines with 4 lines. As many lines as desired may be 
typed during the command to replace as many lines as 
desired. 

Just like APPEND and INSERT, the CHANGE 
command is terminated with a Control D, which must 
immediately follow a Carriage Return. 

All of the editing control characters that may be 
used with APPEND and INSERT may be used with 
CHANGE; they work the same way during CHANGE 
as they do during APPEND and INSERT. 1 

Example 

♦/ 

NOW IS THE TIME FOR 

THE LAZY DOG. 

* TIME'CHANGE -, 



THE QUICK BROWN 
FOX JUMPS OVER -> 



These two lines will re- 
place line 1. 



D c 

*/ 

THE QUICK BROWN 

FOX JUMPS OVER 

THE LAZY DOG. 

* 

EDITOR reassigns line numbers after CHANGE 
just as after DELETE and INSERT. 

The current line after CHANGE is defined as the 
last line typed during the command. 



EDITOR reassigns line numbers after the INSERT 
command. Thus, in the above example, the last line of 
text has line number 2 before the INSERT command, 
whereas afterwards it has line number 4. 

After INSERT, the current line, addressed by ., is 
the last line typed during the INSERT. 



THE COPY COMMAND 

This command has the general form 
aCOPY r ? 

It copies the line or range of lines addressed by r 
and inserts them before the line addressed by a. Up to 



1 - See Use Of Control Characters During APPEND, INSERT, and CHANGE, Page 30. 
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and including 512 lines may be copied with a single 
command. 

Attempting to copy more than 512 lines results in 
the error message: 

TOO MANY LINES 

Example 

»/ 

THIS LINE WILL BE COPIED. 
THEN THIS RANGE OF 
LINES WILL BE COPIED. 
*:THEN:COPY 1 p 

»/ 

THIS LINE WILL BE COPIED. 

THIS LINE WILL BE COPIED. 

THEN THIS RANGE OF 

LINES WILL BE COPIED. 

* 1 COPY:THEN:,: LINES: p 

«/ 

THEN THIS RANGE OF 

LINES WILL BE COPIED. 

THIS LINE WILL BE COPIED. 

THIS LINE WILL BE COPIED. 

THEN THIS RANGE OF 

LINES WILL BE COPIED. 

* 

After the COPY command, the current line, ad- 
dressed by ., is defined to be the first of the lines 
which are copied and inserted. Thus, immediately 
after the second COPY command given in the above 
example, the current line is line 1, 

THEN THIS RANGE OF 



THE MOVE COMMAND 

The general form of the MOVE command is 

aMOVE /-p 

This command moves the line or range of lines ad- 
dressed by r in front of the line addressed by a. Up to 
and including 512 lines may be moved with a single 
MOVE command. 

Attempting to move more than 512 lines results in 
the error message: 

TOO MANY LINES 



Example 

*l 

THIS IS LINE ONE 

THIS IS LINE TWO 

THIS IS LINE FOUR 

THIS IS LINE FIVE 

THIS IS LINE THREE 

THIS IS LINE SIX 

* [SIX] MOVEIFOUR], [FIVE] p 

*/ 

THIS IS LINE ONE 

THIS IS LINE TWO 

THIS IS LINE THREE 

THIS IS LINE FOUR 

THIS IS LINE FIVE 

THIS IS LINE SIX 



REPETITIVE EDITING 



Thus far, we have discussed commands which en- 
able the EDITOR user to edit text within a line and to 
manipulate whole lines of text. We come now to two 
commands which may be used to edit repetitively, 
SUBSTITUTE and FIND. The SUBSTITUTE com- 
mand allows mass substitutions of characters through- 
out any part of the text area. The FIND command is 
even more powerful. It allows the user to execute 
other commands repeatedly; for example, it might be 
used to delete all lines containing the text 'JOB'. It is 
also useful for information retrieval; for example, it 
can be used to find all lines containing any text and 
print them. 



In this section we also discuss two more control 
characters. Control G and Control V, which are espe- 
cially useful with SUBSTITUTE and FIND. 

THE SUBSTITUTE COMMAND 

This command may be used in either of the fol- 
lowing forms: 

SUBSTITUTE p Makes substitutions throughout 
the text. 

/■SUBSTITUTE p Makes substitutions only in the 
line or lines addressed by r. 
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Making Substitutions 
Throughout The Text 

To make substitutions throughout the text, the 
SUBSTITUTE command is used without an address 
as follows: 

SUBSTITUTE p 

"any charactersD c " FOR "characters in text areaD c " 

WAIT? 

After the user types SUBSTITUTE^, EDITOR 
prints a ". The user then types the characters to be 
inserted, terminated by a Control D. EDITOR now 
prompts the user by printing " FOR ". The user types 
the characters to be replaced, again terminating them 
with a Control D. EDITOR prints another ", returns 
the carriage, and asks the question WAIT? The user 
now has two options: 

1. He may tell EDITOR to make all specified sub- 
stitutions by answering WAIT? with an N (for 
No). EDITOR will return the carriage, make all 
substitutions in every line which contains the 
characters to be replaced, and print the number 
of substitutions made. 



Example 

•/ 

ADAMS 

BENTLEY 

BROWN 

DEARBORN 

FIELD 

GREER 

LAMONT 

MEADOWS 

MITTY 

RUFOLO 

SMITH 

SOUTHERN 



$1.50/HOUR 

$2.75/HOUR 

$3.00/HOUR 

$1.75/HOUR 

$1.50/HOUR 

$4.75/HOUR 

S1.25/HOUR 

$3.507HOUR 

$5.50/HOUR 

$3.25/HOUR 

$1.50/HOUR 

$2.50/HOUR 
* SUBSTITUTE p 
"HRD C " FOR "HOURD c " 

WAIT? N The N causes EDITOR to make all 

12 substitutions automatically. EDI- 

« / TOR returns the carriage and prints 

the number of substitutions made, 

12. 



ADAMS 

BENTLEY 

BROWN 

DEARBORN 

FIELD 

GREER 



$1.50/HR 
S2.75/HR 
S3.00/HR 
S1.75/HR 
S1.50/HR 
S4.75/HR 



LAMONT 

MEADOWS 

MITTY 

RUFOLO 

SMITH 

SOUTHERN 



S1.25/HR 
S3.50/HR 
S5.50/HR 
S3.25/HR 
S1.50/HR 
S2.50/HR 



2. He may selectively substitute, telling EDITOR 
when to make the specified substitution and 
when not to make it. This is done by typing a Y 
(for Yes) after the question WAIT?. EDITOR 
will then print the first line of text that con- 
tains the characters to be replaced, and ask the 
question 

OK? 

A Y typed in answer to this question tells 
EDITOR to make the substitution for the first 
occurrence of the characters to be replaced in 
that line. An N tells EDITOR not to make that 
substitution. 

If there is only one occurrence of the charac- 
ters to be replaced in the line printed, EDITOR 
prints the next line and asks OK? again. 
Example 

» APPEND p 

5 CUPS FLOUR p 

3 CUPS SUGAR p 

1 STICK BUTTER ? 
5 CUPS SALT p 

3 TABLESPOONS WATER p 
5 CUPS BAKING SODA p 
D c 

♦ SUBSTITUTE p 

"1 TEASPOOND c " FOR "5 CUPSD " 

WAIT? Y 

5 CUPS FLOUR 

OK?N 

5 CUPS SALT 

OK?Y 

5 CUPS BAKING SODA 

OK?Y 

2 EDITOR has made 2 substitutions out of 3 

* l lines considered. 
5 CUPS FLOUR 

3 CUPS SUGAR 

1 STICK BUTTER 

1 TEASPOON SALT 

3 TABLESPOONS WATER 

1 TEASPOON BAKING SODA 
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If a line contains more than one occurrence of the 
characters to be replaced, the question OK? is asked 
for each occurrence of the characters in the line, as 
follows: After the first OK?, EDITOR prints the same 
line again, this time omitting the first part of the line, 
up to and including the characters first considered. 
This enables the user to see which characters EDITOR 
is asking about. Now OK? is asked for the second oc- 
currence of the characters to be replaced. EDITOR 
continues in this manner until all occurrences of the 
characters to be replaced have been considered, and 
then goes to the next line. 

Example 

•/ 

10 DATA 1.0 5.1 3.2 

20 DATA 4.1 6.2 8.9 

» SUBSTITUTE ? 

",D C " FOR " D c " 

WAIT? Y 

10 DATA 1.0 5.1 3.2 

OK?N 

DATA 1.0 5.1 3.2 

OK?N 

1.0 5.1 3.2 
OK?Y 

5.1 3.2 

OK?Y And this, to the fourth. 

20 DATA 4.1 6.2 8.9 Now, the second line is 
OK?N examined. 

DATA 4.1 6.2 8.9 
OK?N 

4.1 6.2 8.9 
OK?Y 

6.2 8.9 
OK?Y 

4 EDITOR has made 4 sub- 

• / stitutions in 2 lines. 

10 DATA 1.0,5.1,3.2 

20 DATA 4.1,6.2,8.9 

* 

After EDITOR has thus questioned and received 
replies for each occurrence of the characters to be re- 
placed in each line, it prints the number of substitu- 
tions made. 

Making Substitutions 
In A Specified Range 

To make substitutions in a line or lines of text, the 
form 



The user wishes to separate 
his data values with com- 
mas instead of spaces. 

This OK? refers to the first 
space in the line... 
This, to the second... 

This, to the third... 



/-SUBSTITUTE ? 

"any charactersD " FOR "characters in text areaD c " 

WAIT? 

is used, where r is the address of a line or a range of 
lines. This form works exactly like SUBSTITUTE 
without an address, except that substitutions are made 
only in the line or lines addressed by r. 

Some Useful Facts About SUBSTITUTE 

It is possible to substitute nothing for any desired 
characters, thus deleting the specified characters 
throughout the text area. This is done by typing a 
Control D immediately after EDITOR prints the first 
double quote in the SUBSTITUTE command. 

Example 

* I 

LINE ONE 

LINE TWO 

LINE THREE 

» SUBSTITUTE ? 

"D c " FOR "LINE D c " 

WAIT? N 

3 

*/ 

ONE 

TWO 

THREE 



The SUBSTITUTE command may also be used to 
determine the number of occurrences of any charac- 
ter or group of characters in the text, without chang- 
ing the text. This is accomplished by simply substi- 
tuting the character or group for itself. 

Example 

» SUBSTITUTE p 

"ED " FOR "ED " 

WAIT? N 

27 There are 27 E's in the text. 

* SUBSTITUTE p 
"A(D C " FOR "A(D C " 
WAIT? N 

14 There are 14 occurrences of 

* A(. 

After both forms of the SUBSTITUTE command, 
the current line, addressed by ., is defined as the last 
line in which substitutions were made. 

The control characters A c , Q c , W c , and l c may be 
used during the SUBSTITUTE command before 
WAIT? is asked. The other editing control characters 
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discussed under Editing Text Within A Line may not 
be used during this command, however. 

There are two control characters. Control G and 
Control V, which are especially useful with SUBSTI- 
TUTE and FIND. In particular, it is possible to sub- 
stitute Line Feeds or Carriage Returns for other char- 
acters, or vice versa, by preceding each Line Feed or 
Carriage Return with a Control V. Control V and Con- 
trol G may also be used in other situations, which are 
discussed below. 

CONTROL G 

Control G is used to represent any arbitrary char- 
acter. It is used during 

• Line addressing, and 

• The SUBSTITUTE command. 

When Control G is typed, EDITOR prints an ex- 
clamation point. 

Example: Control G Used In Line Addressing 

• [WRITEG C !G C !5] DELETE p 

deletes the line containing the word WRITE followed 
by any two characters followed by a 5. 

Control G is especially useful with the FIND com- 
mand. For example, since the address 

:LABELG C : 

refers to any line having a label consisting of the word 
LABEL followed by any character, the following 
could occur: 

•FIND :LABELG C !:/ This command tells EDI- 



LABEL1 


A 


TOR to print all lines with 


LABEL2 


B 


address. LABELG : 1 


LABELA 


10 




LABEL, 






4 







Example: Control G Used With SUBSTITUTE 

*/ 

1: LINE ONE 

2: LINE TWO 

3: LINE THREE 

4: LINE FOUR 

* SUBSTITUTE p 

"THIS ISD C " FOR "G C !:D C " 

THIS IS is substituted for 
any character followed by 

WAIT? N a colon. 

4 



•/ 

THIS IS LINE ONE 

THIS IS LINE TWO 

THIS IS LINE THREE 

THIS IS LINE FOUR 



CONTROL V 

Control V may be used before a Carriage Return, 
Line Feed, or control character to cause them to be 
accepted as text; that is, to inhibit their usual func- 
tions. V c may be used at any time the user desires to 
inhibit these functions. 

Substituting Line Feeds 
And Carriage Returns 

The SUBSTITUTE command may be used to sub- 
stitute Line Feeds and Carriage Returns for any char- 
acters in the text area, and vice versa. Each Line Feed 
or Carriage Return must be preceded by a Control V 
to inhibit its usual function (line continuation for the 
Line Feed, termination for the Carriage Return). 

Example 

•1/ 

FIRST:SECOND: THIRD 

» SUBSTITUTE p 

D c " FOR ":D C " 

WAIT? N 

2 



•1/ 
FIRST 
SECOND 
THIRD 



Line Feeds have now been substituted for 
the colons. 



If Carriage Returns are substituted for another 
character, EDITOR will not immediately redefine the 
lines of text accordingly. However, if the text is writ- 
ten on a file, or punched on paper tape, and read back 
into EDITOR, the lines will be defined as usual. 

Example 

•1/ 

FIRST 

SECOND 

THIRD 

» SUBSTITUTE p 

"V c p 

D c " FOR "V c ^ 

D c " 



The words FIRST and SECOND are fol- 
lowed by Line Feeds. 



1 - FIND is discussed completely under The FIND Command, Page 37. 
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WAIT? N 

2 

*1/ 

FIRST This is still line 1, even though each phy- 

SECOND sical line ends with a Carriage Return. 

THIRD 

♦WRITE /LINES/ p The text is written on a file. 

NEW FILEp 

7 WORDS. 

» 1,$ DELETE ? 



* READ /LINES/ 



? 



Now all text is deleted and 
the file is read in again. 



7 WORDS. 

•1/ 

F I RST The lines are now defined as usual. 

•2/ 

SECOND 

*3/ 

THIRD 



THE FIND COMMAND 

The FIND command allows the user to execute 
other commands repeatedly for whatever lines in the 
text area he chooses to specify. This section on the 
FIND command explains all the variations of FIND 
available to the EDITOR user, starting with the sim- 
plest forms of the command and proceeding to the 
most complex. 

Basic Forms Of FIND 

There are two basic forms of the FIND command: 



FINDa command 



' FINDa command 



Executes the specified com- 
mand for all lines in the text 
area with address a. 

Executes the specified com- 
mand for all lines in the range 
r with address a 



More complicated FIND commands may be formed 
by using a secondary range and/or by using the condi- 
tionals AND, OR, NOT, and ... 1 . 

Example 

*/ 

95008 CAMPBELL CALIF 

00001 DES MOINES IOWA 
30305 ATLANTA GEORGIA 
60601 CHICAGO ILLINOIS 

80907 COLORADO SPRINGS COLORADO 

00002 GRAND RAPIDS MICH 



00003 HOUSTON TEXAS 

11563 LONG ISLAND NEW YORK 

70118 NEW ORLEANS LOUISIANA 

00005 PEORIA ILLINOIS 
15230 PITTSBURGH PENN 
95803 SACRAMENTO CALIF 

00006 TORONTO CANADA 
94025 MENLO PARK CALIF 

* FIND 'CALIF'/ This FIND tells EDITOR 

to print all lines with ad- 
dress 'CALIF'. 

95008 CAMPBELL CALIF 

95803 SACRAMENTO CALIF 

94025 MENLO PARK CALIF 

3 Three lines containing 

CALIF were found. 

» 1,'SACR' FIND 'CALIF'DELETEp 

This FIND tells EDITOR 
to delete all lines in the 
range 1,'SACR' with ad- 
dress 'CALIF'. 2 

PRINT?N 

2 

»/ 

00001 DES MOINES IOWA 
30305 ATLANTA GEORGIA 
60601 CHICAGO ILLINOIS 

80907 COLORADO SPRINGS COLORADO 

00002 GRAND RAPIDS MICH 

00003 HOUSTON TEXAS 

11563 LONG ISLAND NEW YORK 
70118 NEW ORLEANS LOUISIANA 

00005 PEORIA ILLINOIS 
15230 PITTSBURGH PENN 

00006 TORONTO CANADA 
94025 MENLO PARK CALIF 



The FIND command works as follows: EDITOR 
starts searching for the specified address ('CALIF' in 
the above example) at the beginning of the text area, 
or at the beginning of the range if FIND has been used 
with the address of a range. Whenever it finds a line 
containing the specified address, it executes the com- 
mand used with FIND, for that line. Then it contin- 
ues searching through the text area until it finds an- 
other line with the specified address and executes the 
command for that line. EDITOR continues thus until 
it reaches the end of the text area, or of the range if 
FIND has been used with the address of a range. Thus, 
after FIND, the current line, addressed by ., is the 



1 - See FIND with Secondary Range: The TO Feature, Page 40, and Conditionals Used With FIND, Page 41 . 

2 - See Page 39 for a discussion of the PRINT option available with some of the commands used with FIND, including DELETE. 
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last line in the text area or the last line in the range, 
depending on whether or not FIND has been used 
with the address of a range of lines. 

After the command used with FIND has been exe- 
cuted for all lines with the specified address, EDITOR 
prints the number of lines found with this address, 
and terminates the FIND. 

The following rules about FIND should be ob- 
served : 

• The address following FIND must be a line label 
or a text address. Otherwise, EDITOR will re- 
spond with a question mark. 1 

• Spaces between terms of the command are 
ignored. 

• Line Feeds may be used between terms of the 
FIND command to continue the command pro- 
vided they are preceded by a Control V. 



Commands Used With FIND 

FIND may be used with any of these commands: 

EDIT 
MODIFY 
DELETE 
INSERT 

/ 



FIND may also be followed by a Carriage Return 
without a command, to obtain the number of lines 
with the specified address. 

Example 

•/ 

LINE ONE 

LINE TWO 

LINE THREE 

» FIND :LINE: ? 

3 

» 

NOTE: The = and ■*- commands are discussed fully 
in Section 4, Utility Commands. Both commands are 
used with the address of a single line. Briefly, the = 
command prints the EDITOR line number of the line 
addressed. The *- command prints a line label address 
of the line addressed, if this line has a line label begin- 
ning in print position 1. Thus, for example, if line 44 
in the text area is 

JONES 1843 S NORTH STREET 



these commands could be used as follows: 

* 'NORTH'=44 
*44+- 
JONES 

* 

When FIND is used with the EDIT command, 
EDITOR prints the specified lines one at a time. After 
printing a line, it waits for the user to edit it. At this 
point, the user may proceed just as if he were using 
the EDIT command; all control characters available 
during EDIT may be used. After he terminates the 
edit, EDITOR prints the next line to be edited. 

Example 

*/ 

THIS IS LINE TWO 
THIS IS LINE TWO 
THIS IS LINE THREE 
THIS IS LINE TWO 

• FIND 'TWO' EDIT p 
THIS IS LINE TWO 
Z C ETHIS IS LINE ONE ? 
THIS IS LINE TWO 

F c 

THIS IS LINE TWO 

Z C ETHIS IS LINE FOUR p 

3 

*/ 

THIS IS LINE ONE 
THIS IS LINE TWO 
THIS IS LINE THREE 
THIS IS LINE FOUR 



FIND used with MODIFY works just like FIND 
with EDIT, except that the lines to be edited are not 
printed. 

When FIND is used with INSERT, EDITOR prints 
the lines addressed one at a time and waits for the user 
to type the text to be inserted. Two things should be 
remembered: 

• The text typed must be terminated with a Con- 
trol D. 

• The line printed is the line before which the 
text will be inserted. 

Example 

*/ 

LINE TWO 

LINE FIVE 

» FIND : LINE: INSERT-, 



1 - This address may be modified using the conditionals discussed on Pages 41-45. 
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LINE TWO 

LINE ONE ? 

D c 

LINE FIVE 

LINE THREE ? 

LINE FOUR ^ 

D c 

2 

•/ 

LINE ONE 

LINE TWO 



LINE THREE 
LINE FOUR 
LINE FIVE 

• 

When FIND is used with DELETE, =, and *-. 
EDITOR asks the question PRINT? after the com- 
mand is given. This question may be answered with 
either a Y (for Yes) or an N (for No). No Carriage Re- 
turn need be typed after Y or N since EDITOR re- 
turns the carriage. Here are the results of each re- 
sponse: 



Command Used 
With FIND 


Result Of Response To PRINT? 


Y 


N 


DELETE 


The lines found are printed 
one at a time; EDITOR asks 
OK? after printing each line. 
Now, a Y tells EDITOR to de- 
lete the line just printed; an N, 
not to delete it. 


Ail lines found are deleted. 




EDITOR prints the line num- 
ber followed by the line it- 
self, for each line found. 


EDITOR prints the line num- 
bers of all lines found. 
NO TE: The last number in the 
list is the number of lines 
found, not an EDITOR line 
number. 


«- 


EDITOR prints each line 
found, thus making its line 
labels plainly visible. 


EDITOR prints a line label ad- 
dress for each line found, if 
the line has a line label begin- 
ning in print position 1. 1 



Example: FIND With DELETE 



*/ 

95008 CAMPBELL CALIF 

00001 DES MOINES IOWA 
30305 ATLANTA GEORGIA 
60601 CHICAGO ILLINOIS 

80907 COLORADO SPRINGS COLORADO 

00002 GRAND RAPIDS MICH 

00003 HOUSTON TEXAS 

11563 LONG ISLAND NEW YORK 
70118 NEW ORLEANS LOUISIANA 

00005 PEORIA ILLINOIS 
15230 PITTSBURGH PENN 
95803 SACRAMENTO CALIF 

00006 TORONTO CANADA 
94025 MENLO PARK CALIF 



* FIND '0000'DELETE ? 
PRINT7Y 

00001 DES MOINES IOWA 
OK?Y 

00002 GRAND RAPIDS MICH 
OK?Y 

00003 HOUSTON TEXAS 
OK?Y 

00005 PEORIA ILLINOIS 
OK?Y 

00006 TORONTO CANADA 
OK7N 

5 Five lines with address '0000' were found; 

* I only four lines were deleted. 

95008 CAMPBELL CALIF 

30305 ATLANTA GEORGIA 

60601 CHICAGO ILLINOIS 

80907 COLORADO SPRINGS COLORADO 



1 - If any of the lines found do not have a line label beginning in print position 1, the ■*- command works somewhat differently 
than described here. See Section 4, Utility Commands. 
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11563 LONG ISLAND NEW YORK 
70118 NEW ORLEANS LOUISIANA 
15230 PITTSBURGH PENN 
95803 SACRAMENTO CALIF 
00006 TORONTO CANADA 
94025 MENLO PARK CALIF 



FIND With Secondary Range: 
The TO Feature 

A secondary range, of the form 

a t TO a 2 

may be used with both forms of the FIND command. 
Thus, both of the following are allowed: 

FIND a, T 0a2 ,a co a m " ma a nd 

Executes the specified com- 
mand for all lines addressed 
by a which are found in each 
secondary range ai TO a 2 in 
the text area. 

rFIND a, TO a 2 , a J^ nA 

Executes the specified com- 
mand for all lines with ad- 
dress a found in each secon- 
dary range a, TO a 2 in the 
range r. 

In the above, a x , a 2 , and a are all addresses of a 
single line. Further, they must all be text addresses or 
line labels. The secondary range must be separated 
from the address a by a comma. 

The secondary range a^ TO a 2 includes all lines 
from the line addressed by a x to the line addressed by 
a 2 , inclusive. 

Example 

*l 

PICKING JUST SIX QUINCES, NEW 
FARMHAND PROVES STRONG BUT LAZY. 

START OF SECONDARY RANGE 1 

A QUICK BROWN 

FOX JUMPS OVER 

THE LAZY DOG. 
END OF SECONDARY RANGE 1 

PICKING JUST SIX QUINCES, NEW 
FARMHAND PROVES STRONG BUT LAZY. 



START OF SECONDARY RANGE 2 

A QUICK BROWN 

FOX JUMPS OVER 

THE LAZY DOG. 
END OF SECONDARY RANGE 2 
• FIND :START: TO :END:/LAZY7 

THE LAZY DOG. 

THE LAZY DOG. 
2 
• 

Here all lines containing the text LAZY that are 
also in one of the two occurrences of the secondary 
range :START: TO :END: are printed. The two lines 
outside the secondary ranges which contain LAZY are 
not printed. 

A secondary range is not at all the same as the ad- 
dress of a range of lines which may precede the FIND 
command. If a secondary range is used with FIND, 
EDITOR searches all such ranges for the specified ad- 
dress. If the address of a range of lines is used before 
the FIND command, only one such range will be 
searched for the specified address. Thus, in the above 
example, using the address :START:,:END: before 
the FIND yields the following: 

*./ 

END OF SECONDARY RANGE 2 

» : START:,: END: FIND'LAZY'= 

PRINT7Y Which range is searched depends on the 
current line at the time the command 
is given. The search for the first address 
in the range begins at the line addressed 
by.+1. 

1 

THE LAZY DOG. 

1 

»./ 

END OF SECONDARY RANGE 1 

* :START:,: END: FIND'LAZY'= 

PRINT7Y 

16 

THE LAZY DOG. 

1 

As already indicated, FIND may be used with both 
a range r and a secondary range a\ TO a 2 . 

Example 

*1.<PICKING>FIND:START: TO :END:/LAZY'= 

PRINT7Y 

7 

THE LAZY DOG. 
1 
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Conditionals Used With FIND 

The following conditionals may be used with 
FIND: 

NOT 
AND 
OR 



Before discussing the rules by which these condi- 
tionals work, we give an example using two of them: 

*/ 

BIG HOUSE 

SMALL HOUSE 

BIG CAT 

BIG DOG 

SMALL FISH 

» FIND 'BIG' AND NOT 'HOUSE' DELETE ? 

PRINT?N 

2 

»/ 

BIG HOUSE The lines BIG CAT and BIG DOG 

SMALL HOUSE contain the text BIG and not the 

SMALL FISH text HOUSE; hence, they wen? 

« deleted. 



The command FIND 'BIG' AND NOT 'HOUSE' 
DELETE deletes all lines which contain the text BIG 
and do not contain the text HOUSE. 

'BIG' AND NOT 'HOUSE' is an example of a con- 
ditional expression. It is legal to use a conditional ex- 
pression in place of the final address a in both forms 
of the FIND command. Thus, 

FIND conditional expression CO m m | n d 
rFIND conditional expression co a m n ma a nd 

are both legal forms of FIND. Conditional expressions 
may be used in conjunction with a secondary range, 
so that 

FIND a x TO a 2 . conditional expression CO m m a nc j 
rFIND a x TO a 2 , conditional expression CO m m and 

are legal. In addition, the conditional NOT may be 
used to modify either or both of the addresses a x and 
a 2 in the secondary range. 1 Thus, the most general 
form of the FIND command is as follows, where 
everything in brackets is optional: 



conditional 
H FIND [WOT!.! TO [NOTja,]*^ ion co a m " ma a nd 

address a 

The addresses used in the conditional expression, 
such as 'BIG' and 'HOUSE' above, must be line labels 
or text addresses just as the addresses a x , a 2 , and a 
must be. 

Rules For Using Conditionals With FIND 

1. Using NOT In A Conditional Expression 

The conditional NOT may be used with FIND be- 
fore any line label or text address. For example, 

FIND NOT 'DATA' EDIT p 

allows edit of all lines in the text area which do not 
have the text DATA in them. 

When EDITOR encounters a command of the form 

FIND NOT a c ™^ nd 

it searches all lines in the text area for the label or 
text comprising a. Each line of text is searched from 
left to right. If the text or label is not found in the 
line, the condition is satisfied; that is, EDITOR will 
execute the specified command for that line. 

One particularly useful feature of FIND involves 
the conditional NOT and the control characters G c 
and V c . These may be used to remove blank lines from 
the text area, as shown in the following example: 

»/ 

LINE 1 There are four lines consisting of a Car- 
riage Return alone in the text area. 
LINE 2 



LINE 3 

•FIND NOT 'G c !V c p This command deletes all 

'DELETE -j these blank lines. 

PRINT7N 

4 

*/ 

LINE 1 

LINE 2 

LINE 3 



As already mentioned, NOT may be used to modi- 
fy either address in a secondary range a x TO a 2 - If 
NOT modifies a x , the first line of the range is the first 
line EDITOR finds not containing the text or label 
comprising a x . If NOT modifies a 2 , the last line of the 
range is the first line following the first line in the 



1 - See Rules For Using Conditionals With FIND, Rule 1, below, for the meaning of NOT in a secondary range. 
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range (addressed by either a t or NOTai) which does 
not contain the text or label comprising a 2 ■ 

Example 

«/ 

BIG RED HOUSE 

SMALL HOUSE] _.. . ,. . 

I This is the secondary range 

' searched. 



RED CAT 

BIG DOG 

SMALL FISH 

• FIND NOT 'BIG' TO NOT 'CAT', 'RED'/ 

RED CAT 

1 

• 

Do not forget that EDITOR searches all occur- 
rences of the secondary range for the specified text. 

2. Using AND In A Conditional Expression 

AND is allowed between any two line label or text 
addresses. For example, 

FIND 'AXT' AND 'TYPE' INSERT ? 

allows inserting text before all lines containing both 
AXT and TYPE. 

When EDITOR encounters a command of the form 

FIND 3l AND a 2 co a m n m a nd 

it first searches the lines of text from left to right for 
the text or label comprising a t . If a line contains this 
string, it is searched again, this time for the text or 
label comprising a 2 . If this string is found, the AND 
is satisfied; EDITOR will execute the specified com- 
mand for that line. 

The addresses on either side of the AND may be 
modified by a NOT. Thus, the following conditional 
expressions are permitted: 

a, AND NOT a 2 
NOT a, AND a 2 
NOT aj AND NOT a 2 

When EDITOR encounters one of these expres- 
sions in a FIND command, its search of the text is the 
same as for a l AND a 2 , except that lines are checked 
for the absence of the string modified by NOT. 

Example 

FIND NOT :DATA: AND '20.17 

prints all lines which do not have the line label DATA, 
but do contain the text 20.1 . This example is equiva- 
lent to 

FIND '20.1' AND NOT :DATA:/ 



3. Using OR In A Conditional Expression 

The conditional OR is an inclusive OR. It is al- 
lowed between any two text or line label addresses. 

Example 

FIND 'CALIF' OR 'COLORADO'/ 

prints all lines which contain either CALIF or 
COLORADO, or both. 

When EDITOR encounters a command of the form 

FIND a, OR a 2 J m " ma a nd 

it first searches the lines of text, from left to right, for 
the text or label comprising a t . If a line contains this 
string, the OR is satisfied for that line, so no search 
for the string comprising a 2 is necessary. EDITOR will 
execute the specified command for that line. If a line 
does not contain the string comprising a x . it is 
searched again, this time for the string comprising a 2 . 
The OR is also satisfied if this string is found; 
EDITOR will execute the specified command for this 
line. 

As with AND, the addresses on either side of the 
OR may be modified by NOT. If this is done, the 
search is the same, except that lines are checked for 
the absence of the string modified by NOT. 

Example 

FIND [12] OR NOT :EMP: EDIT ? 

allows editing of all lines which contain the text 12, 
or which do not have the line label EMP. 

4. Using ... In A Conditional Expression 

The conditional ... is used to indicate that one ad- 
dress follows another address. It is permitted between 
any two text addresses, or between a line label and a 
text address. 

Example 

«/ 

BIG TREE 

BIG HOUSE 

HOUSE OF BIGG 

SMALL HOUSE 

BIG RED HOUSE 

• FIND 'BIG' ... 'HOUSE'/ This command prints 

BIG HOUSE all lines which con- 

BIG RED HOUSE tain the textBIG fol- 

2 lowed by the text 

. HOUSE. 

When EDITOR encounters a command of the form 

FIND a t ... a 2 J*£* 
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it scans the lines of text as follows: First, EDITOR 
searches a line from left to right for the string com- 
prising di . If this string is found, the rest of the line is 
searched for the string comprising a 2 . If this string is 
found in the rest of the line, the ... is satisfied; the 
specified command is executed for that line. 

NOT may be used to modify the address on the 
right of the ...; for example, consider the following: 

«/ 

BIG TREE 

BIG HOUSE 

HOUSE OF BIGG 

SMALL HOUSE 

BIG RED HOUSE 

♦ FIND 'BIG' ... NOT 'HOUSE'/ 

This command prints all 
lines which contain the text 
BIG, but do not contain 
the text HOUSE following 
BIG. 

BIG TREE 

HOUSE OF BIGG 

2 



► CAUTION: The condition 

NOT a x ... a 2 

can never be satisfied. To see why this is so, consider 
this example 

*/ 

A B 

C B 

BCD 

X Y Z 

*FIND NOT 'A' ... 'B'/ 

Zero occurrences of NOT 

* 'A' ... 'B' are found. 



In this example, EDITOR first scans each line from 
left to right for the string A. If A is found, the line is 
rejected. Once EDITOR has determined that a line 
does not contain the string A, it has scanned the en- 
tire line and is positioned at the end of the line. Now 
EDITOR considers the ... in the command, which tells 
it to search the rest of the line for the text B. But 
since EDITOR is now at the end of the line, none of 
the line remains to be searched. Thus, B cannot be 
found in the rest of the line; that is, NOT 'A' ... 'B' 
can never be satisfied. 1 



5. Combining The Conditionals 

As many addresses as desired, separated by AND, 
OR, or ..., may be used in a conditional expression, as 
long as the total length of the FIND command does 
not exceed 256 characters. Each address in such ex- 
pressions may be modified by a NOT; the addresses 
must all be text addresses or line labels, as usual. Thus, 
the following are all legal: 

FIND a, AND a 2 OR a 3 co a ^ ma a nd 

FIND a, OR a 2 AND NOT a 3 co a ^ ma a nd 

FIND a, ... a 2 AND a 3 ... a 4 OR a 5 co a ^ m a nd 

6. Evaluation Of Conditional Expressions 

EDITOR evaluates conditional expressions from 
left to right. This rule is important; it implies, for 
example, that 

'A' OR 'B' AND 'C 

designates all lines containing either 

A and C 

or 
B and C 

rather than lines containing 

A 

or 

B and C 

because the expression is evaluated in the following 
order: 

'A' OR 'B' AND 'C 
1 

< . v ' 

2 

Addresses and conditionals may be grouped with 
parentheses to change the usual order of operation. 
Thus, 

FIND 'A' OR CB' AND 'C')/ 

will print all lines containing either 

A 

or 

B and C 

► NOTE: The conditional ... always modifies only 
the immediately preceding address. Thus 

'A' OR 'B' ... V 

is equivalent to 

'A' OR CB' ... 'C') 

and not to ('A' OR 'B') ... 'C. The latter expression is 
both meaningless and illegal, (see the restrictions on 



To find all lines which do not contain A followed by B, the conditional expression 'A' ... NOT 'B' OR NOT 'A' may be 
used. See rules 5 and 6. 
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the use of parentheses listed below.) To find all lines 
con taining either A followed by Cor B followed by C 
use 

FIND {'A' ... 'C') OR ('B' ... 'C') 

Note also that NOT always modifies only the ad- 
dress immediately following it. 

Example 

The conditional expression 
'A' AND NOT 'B' OR 'C ... 'D' 
is equivalent to 
'A' AND (NOT 'B') OR CC ... 'D') 

It designates all lines containing either 

A and not B 

or 

C followed by D 

There are three restrictions on the use of paren- 
theses: 

• NOT may never modify a parenthetical group; 
thus, FIND 'A' AND NOT ('B' OR 'C') is not 
allowed. To find all lines containing A and 
neither B nor C, use 

FIND 'A' AND NOT 'B' AND NOT 'C 

• The conditional ... may never modify a paren- 
thetical group; thus, FIND ('A' OR 'B') ... 'C 
is not allowed. 



• Only one level of parentheses is allowed; that is, 
nested parentheses are illegal. 

Examples 

FIND 'ABC OR ('STE' AND 'Q') OR 'V07 

prints lines containing ABC, or both STE and Q, or 
VO. 

FIND ('DATA' ... '2') AND CC OR 'B')/ 

prints lines containing both 

DATA followed by 2 
and 
C 
or 

DATA followed by 2 

and 

B 

7. Abbreviation Of Conditionals 

The conditionals may be abbreviated as follows: 

N for NOT 
A for AND 
O for OR 
. for ... 
AN for AND 
ANN for AND NOT 



We conclude this section with the examples beginning on the next page, which illustrate 
the way EDITOR evaluates various conditional expressions. 
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Example 1: NOT and 

• / 



Example 2: AND and OR 

•/ 



A 




A 


B 




B 


C 




C 


A B 




A B 


B A 




B A 


A C 




A C 


C A 




C A 


B C 




B C 


C B 




C B 

• FIND 'A' OR 'B' AND 'C7 


ABC 




'A ' OR 'B' and 'C is equiv- 


A C B 




alent to ('A' OR 'B') AND 


B A C 




'C. 


B C A 




A C 


CAB 




C A 


C B A 




B C 


* FIND 'B' ... 

B 

A B 


, NOT 'A7 


C B 

4 

» FIND 'A' OR CB' AND 'C')/ 


B C 
C B 
ABC 
A C B 
CAB 
7 




A 

A B 
B A 
A C 
C A 
B C 


» FIND NOT 


'A' ... 'B7 


C B 




Recall that FIND com- 


7 




mands of this form always 


• 




find no lines. 











• FIND 'A' ... 


, NOT 'B' OR NOT 'A7 




A 


This command finds all 




B 


lines which do not contain 




C 


A followed by B. Note 
that the two blank lines 




B A 
A C 


in the text are among the 
13 lines found. 




C A 






B C 






C B 






B A C 






B C A 






C B A 






13 






* 
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Example 3: 


OR and 


*/ 


f 






A 








B 








C 








A 


B 






B 


A 






A 


C 






C 


A 






B 


C 






C 


B 






A 


B C 






A 


C B 






B 


A C 






B 


C A 






C 


A B 






C 


B A 






*l 


: IND 'A' 


OR 


'B' 



•ci 

'A' OR 'B' ... Vis equiva- 
lent to 'A' OR CB'... 'C'). 



A 

A B 

B A 

A C 

C A 



C 
B 
C 
A 
C 
A 
B 



B 

A 

A 

B 

B 

C 

C 

12 

♦FIND ('A' 

A C 

B C 

A B 

A C 

B A 

B C 

6 



'O OR CB' 



'C')/ 



Example 4: AND, OR, NOT, and 

•/ 

A 

B 

C 

D 



A B 

B A 

A C 

C A 



B 
C 
A 
D 
B 
D 
C 
D 



« FIND 'A' AND NOT 'B' OR 

A 

A C 

C A 

A D 

D A 

C D 

6 

• 



'C ... 'D7 
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SECTION 4 
UTILITY COMMANDS 



In addition to commands for input, output, and editing of text, EDITOR has the fol- 
lowing utility commands: 



Command 


Function 


CLEAR 


Erases contents of text area. 


LINES n 


Sets n lines per page for the PRINT command. 


TABS number list 


Changes tabs from initial 8, 16, 32, 40, 45, 50, 55, 60, 65, 
70, to positions specified in number list. 


3 = 


Types EDITOR line number of line addressed by a. 


a<- 


Types a line label address for line addressed by a. 


QUIT 


Returns to the EXECUTIVE. 


1 


Prints the next line, addressed by .+1 . 


t 


Prints the previous line, addressed by .+1. 



The commands LINES, ~l, and t were discussed 
fully under Output Of Text From Text Area, Page 17. 

The QUIT command simply returns the user to the 
EXECUTIVE. 

THE CLEAR COMMAND: 
CLEARING TEXT AREA 

This command erases the entire contents of the 
text area. It is used as follows: 
» CLEAR p 
ALL? 

After the user types CLEAR followed by a Car- 
riage Return, EDITOR responds with ALL?. At this 
point, typing a Y (for Yes) confirms the command. 
Typing an N (for No) aborts it. No Carriage Return 
need be typed after the Y or N, since EDITOR returns 
the carriage automatically. 

THE TABS COMMAND: 
SETTING TAB STOPS 

Up to ten tab stops may be set with the TABS 
command. 

The general form of the command is 

TABS number list-) 

where the number list consists of the print positions 
at which tab stops are to be set, separated by commas. 

Example 

• TABS 5,10,15,20 ^ 
» APPEND -, 



12345678901234567890 ? 

ic *|C *|C »|c . ? R eca u tnat ic spaces up 

D c to the next tab stop. 

* I 



1 2345678901 234567890 



In this example, tab stops were set at print posi- 
tions 5, 10, 15, and 20. 

Once the TABS command has been given, EDITOR 
assumes tab stops at the specified print positions un- 
til another TABS command has been given. Even if 
CLEAR has been given, the last TABS command re- 
mains in effect. 

If no TABS command has been given, EDITOR 
assumes tab stops at print positions 8, 16, 32, 40, 45, 
50, 55, 60, 65, and 70. NOTE: Each tab stop specified 
with the TABS command replaces one previously set 
tab stop. This means that when fewer than 10 tab 
stops are set with TABS, the remaining preset tabs 
will still be set. For example, 

*TABS 5,10,15,20 ^ 

causes the preset tab stops at print positions 8, 16, 32, 
and 40 to be replaced by new tab stops at print posi- 
tions 5, 10, 15, and 20, respectively. Therefore, after 
execution of this command there are tab stops set at 
print positions 5, 10, 15, 20, 45, 50, 55, 60, 65, and 
70. 

This command has no effect on the current line. 



48 



THE = COMMAND: 
DETERMINING A LINE NUMBER 

The general form of this command is 



where a is the address of a single line. It prints the 
EDITOR line number of the line addressed. 

Example 

•/ 

LINE ONE 
LINE TWO 
LINE THREE 
LINE FOUR 

• [TWO] =2 

There is no need to type a Carriage Return after 
this command. EDITOR prints the line number as 
soon as the user types the =. 

If the LINES command has been given previously, 
the = command prints the page number, and the line 
number on that page, of the line addressed, as well 
as the EDITOR line number. Thus, if the command 

LINES 10 

has been given, and the third line on page two is 
NOW IS THE TIME 
the following may occur: 

* :NOW:=PAGE 2 LINE 3 ;13 

After execution of the = command, the current 
line, addressed by . , is the line whose line number was 
printed. 

THE «- COMMAND: 
DETERMINING A LINE LABEL 



The general form of this command is 



this command prints its line label. If the line does not 
have such a line label, it prints the line label of the 
nearest preceding line having a line label beginning in 
print position 1, plus a number indicating how far 
away the line is. 

Example 

*/ 

ONE FIRST 

TWO SECOND 

THREE THIRD 

*"FIRST"^ 

ONE 

*"THIRD"<- 

TWO+1 



a*- 



where a is the address of a single line. If the line ad- 
dressed has a line label beginning in print position 1, 



This line does not have a line 
label beginning in print posi- 
tion 1. 

The nearest line having a line 
label in print position 1 is the 
line with label TWO; this line 
is one line before the line ad- 
dressed. 



If no line preceding the line addressed has a label be- 
ginning in print position 1, EDITOR simply returns 
control to the user. 

There is no need to type a Carriage Return after 
the <- command. EDITOR returns the carriage and 
types the line label. After the *- command, the cur- 
rent line, addressed by ., is the line addressed by the 
■*- command. 

If the LINES command has been given previously, 
the *- command prints the page number and line num- 
ber on that page of the line addressed, as well as the 
line label. Thus, if the LINES command has been 
given and the line 

TOTAL SALES FOR JULY 

is the second line on page two, the following may 
occur: 

* 'JULY'-s- 

PAGE 2 LINE 2 ;TOTAL 
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SECTION 5 
ADVANCED EDITOR FEATURES 



In this section we discuss the ten buffers which are 
available for storing text, commands, and control 
characters. Using these buffers, editing "programs" 
may be created to simplify greatly the user's editing 
work. 

In the subsection Use Of Buffers, we also discuss 
some advanced editing techniques using buffers and 
some of the commands discussed in Section 4. 

GENERAL DESCRIPTION 
OF BUFFERS 

EDITOR has ten buffers numbered through 9. 
Information may be entered into these buffers from 
either the terminal or the text area. 

Buffers 1 through 9 hold up to and including 8 
lines of information. 

Buffer holds up to 80 lines; however, only 8 
lines may be entered from the terminal. 

The contents of any buffer may be printed on the 
terminal. 

Buffers may be loaded with any characters that can 
be typed from the terminal; the contents may then 
serve as a source of commands, text and/or control 
characters for use in editing the text in the text area. 

OUTPUT FROM A BUFFER 
TO THE TERMINAL 

There is only one command for output from a buf- 
fer, which prints the contents of the buffer at the 

terminal. The general form of this command is 

nBUFFER ? 

where n is the number of the buffer whose contents 
are to be printed. When the command is given, EDI- 
TOR prints the contents of the buffer surrounded by 
quotes. 

Example 

If buffer 3 contains the text 

THIS IS IN BUFFER 3 

the following may occur: 

»3BUFFER ? 

"THIS IS IN BUFFER 3" 

* 

This command has no effect on the current line. 



The contents of a buffer may be transferred to the 
text area by using Control B at the appropriate time. 
See Use Of Buffers, Page 50. Thus, other commands 
for output from a buffer are unnecessary. 

INPUT TO A BUFFER 

Input From The Terminal 

The command for input to a buffer from the termi- 
nal has the form 

nLOAD ? 

Text, commands, and/or control characters to be 

enteredD c 

The command is terminated with a Control D, 
which should immediately follow the information to 
be stored. No Carriage Return need be typed pre- 
ceding the terminating D c . In fact, if a Carriage Re- 
turn is typed, it will be stored in the buffer along with 
the rest of the information typed at the terminal. 

Examples 

»5 LOAD ? 

THIS TEXT IS STORED IN BUFFER 5D C 

*5 BUFFER ? 

"THIS TEXT IS STORED IN BUFFER 5" 

•1 LOAD ^ 



'READ' EDIT ? 

D c 

* 1BUFFER ? 

"'READ' EDIT 



Here, a command is stored in 
buffer 1. 



The " prints below the com- 
* mand because the Carriage 

Return following the com- 
mand is stored in the buffer. 

If there is anything already in a buffer when a 
LOAD is given, the new LOAD erases this and inserts 
whatever was specified in its place. 

The control characters A c , Q c , W c , and l c are avail- 
able for editing during LOAD. 

This command has no effect on the current line. 

NOTE: If too many lines are typed during LOAD, 
the error message 

MAXIMUM LOAD IS: 80 LINES IN AND 8 

LINES IN 1 THRU 9 
? 

will be printed. Nothing will be stored in the buffer. 
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Input From The Text Area 

There are two commands for entering lines of text 
in the text area into a buffer. 

1 . The command 

r;nLOAD p 

puts the line or lines addressed by r into buffer 
n. The lines put into the buffer are not deleted 
from the text area. 

Example 

* 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

« 1,9;0LOADp 

♦ OBUFFERp 



'1 



2 

3 
4 
5 
6 
7 
8 



Note that more than 8 lines 
may be put into buffer if 
they are entered from the text 
area. 



3 

4 

5 

6 

7 

8 

9 

10 

» 5,10;9GET ? 

»9BUFFER ? 

"5 

6 

7 

8 

9 

10 



*/ 

1 

2 

3 

4 



Note that lines 5 through 10 are no longer in 
the text area. 



After the GET command, the current line, ad- 
dressed by ., is the line preceding the first line 
put into the buffer. If the first line in the text 
area is put into the buffer, the current line is 
simply the first line of text remaining in the 
text area. Not surprisingly, this is the same rule 
by which the current line is defined after 
DELETE. 

Like LOAD, GET is destructive to anything 
previously stored in the buffer. 



This form of LOAD is also destructive in that 
anything in the buffer before the command is 
given is erased when the LOAD is given. 

This form of LOAD also has no effect on the 
current line. 

2. The command 

r.nGBJ ? 

puts the line or lines addressed by r into buffer 
n and also deletes them from the text area. 

Example 



/ 



1 
2 



ERASING THE CONTENTS 
OF A BUFFER 

The command 

nKILLp 

erases the contents of buffer n. It is not used very 
often, since LOAD is destructive. It has no effect on 
the current line. 

Note that the CLEAR command erases the con- 
tents of the buffers as well as of the text area. 

USE OF BUFFERS 

Buffers are used as a source of text, commands, 
and/or control characters. They are particularly useful 
when a string of text is required in several places, or 
when a given command or sequence of commands is 
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to be executed several times in succession. The infor- 
mation needed repetitively is stored in buffers, and 
when it is needed, the user may access them with 
Control B. 

Control B 

The general form 

B C /7 

is used to take commands, text, and/or control charac- 
ters from buffer n. When Control B is typed, EDITOR 
prints a cross hatch (#) to indicate its use. 

Control B may be used to call a buffer at any time. 
As soon as the buffer number n is typed, the contents 
of the buffer are called; there is no need to type a 
Carriage Return after the buffer number. 

Often, text, commands, and control characters are 
all stored in one buffer. The important rule to remem- 
ber in understanding how buffers work is the follow- 
ing: 

► When the contents of a buffer are called with 
Control B, EDITOR interprets them exactly as 
if they were typed at the terminal. 

Using Control B does not erase the contents of the 
buffer called. 

Text In A Buffer 

If EDITOR happens to be expecting text when 
Control B is used, as, for instance, during APPEND, 
the contents of the buffer are interpreted as text. 

Example 



• 5LOAD p 




THIS IS LINE 


D 


APPEND p 




B c #51 p 




B c #52 ? 




B c #53 ? 




D c 




*/ 




THIS IS LINE 


1 


THIS IS LINE 


2 


THIS IS LINE 


3 



Commands In A Buffer 

On the other hand, if EDITOR is awaiting a com- 
mand, as indicated by the asterisk, EDITOR takes a 
command from buffer n when B c n is typed. NOTE: 

SUBSTITUTE and FIND may not be stored in a 
buffer. 



Example 

• / 

33.4, 55.6 
1, 

0, 1 
44.6, 65.2 

33.1, 89.5 

1, 
0, 1 

34.2, 33.6 

* 3LOAD ? 
:1,:,:0,:DELETE ? 
B C &B3D C 

» B c #3 
? 

•/ 

33.4, 55.6 

44.6, 65.2 

33.1, 89.5 

34.2, 33.6 



In this example, the user wishes to delete the range 
of lines 

1. 
0, 1 

everywhere it occurs in the text area. To do this, he 
loads buffer 3 with the command 

:1,:,:0,:DELETE ? 

By itself, this command would delete only one 
such range (which range would depend on the location 
of the current line when the command was given). To 
execute this command repetitively, the user stores a 
B c 3 in the buffer. EDITOR prints &B instead of # 
when B c is typed during LOAD, to indicate that the 
control character has been stored in the buffer instead 
of performing its usual function. 1 The user terminates 
the LOAD with a Control D. Now, when he calls the 
buffer using B c 3, EDITOR is awaiting a command, so 
it takes the first command from the buffer and exe- 
cutes it just as if it were typed at the terminal. One of 
the specified ranges of lines is deleted. Then EDITOR 
looks for the next thing in the buffer, which is a B c 3. 
This tells EDITOR to call the contents of buffer 3 
again. Another specified range of lines is deleted and 
buffer 3 is called. This time, there are no more ranges 
addressed by 

:1,:,:0,: 



1 - See the following discussion on storing control characters in a buffer. 
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in the text area, so EDITOR prints a ? and returns 
control to the user. 

This example points out two useful features of 
buffers: 

• Control characters may be stored in a buffer. 

• A buffer may call itself or another buffer, since 
Control B may be stored in it. 

Control Characters In A Buffer 

Most control characters are automatically stored in 
a buffer instead of performing their usual functions 
when they are typed during the LOAD command. 
When one of these control characters is typed, EDI- 
TOR prints an ampersand followed by the character 
typed. For example, F c prints as &F during LOAD. 

The following control characters are not automati- 
cally stored in a buffer when typed during LOAD. 
These six control characters may be stored in a buffer 
by preceding them with a Control V when they are 
typed, to inhibit their usual functions: 

1. The four control characters available for editing 
purposes during LOAD (A c , Q c , W c and l c ) are 
not stored in a buffer when typed during 
LOAD, but instead perform their editing func- 
tions. For example, in the following, 

* 1LOAD ? 
.+3NA c -HVIODI FY ? 

the Control A deletes the preceding character; 
it is not stored in buffer 1. 

2. Control D, since it terminates the command, is 
not stored in the buffer when it is typed during 
LOAD. 

3. Control V must be preceded by Control V to 
store it in a buffer. 

Example 

*/ 

BROWN E36 

JONES75 

SMITH15 

THOMAS 

* 5LOAD ? 

H C &HV C A C &AV C A C &A ? 

B C &B5D C 

*1,3MODIFYp 

B c #5»/ 

BROWNE 

JONES 

SMITH 

THOMAS 



In this example, the user wishes to delete the num- 
bers from the end of lines 1 through 3 in the text area. 
He may use the same sequence of control characters 
in editing each line, so he puts these characters in a 
buffer. Control H will copy the old line to the new 
line, then the two Control A's will delete the last two 
characters in the new line. The Carriage Return will 
terminate the edit, and then B c 5 will call buffer 5 
again, making the control characters available for the 
next edit. Note that each Control A is preceded by a 
Control V to inhibit its usual function. 

For the actual edit of lines 2 through 3, the user 
types 

1,3MODIFY ? 

B c #5 

Control characters are now taken from buffer 5 until 
all lines have been edited. At this point, EDITOR re- 
turns control to the user with an asterisk. 

We conclude this section with a complete editing 
example, which demonstrates a technique for per- 
forming the same editing on every other line of text 
in the text area by storing the command 

.+2MODIFY ? 

in a buffer. In general, this technique may be modified 
to edit every n lines in the text area by using 
.+/7MODI FY. It may be used to edit every line of text 
in the text area; however, this is more easily accom- 
plished by using 

1,$MODIFY ? 

and storing the control characters and/or text in a 
buffer, as in the preceding example, or by storing 

MODIFY-], 

in a buffer. 

Other examples of editing techniques using buffers 
are found in Section 6 of this manual. 

Example 

- EDITOR ? 

*READ /PAY1/p 

53 WORDS. 

*/ 

ADAMS, JOHN,34821 

1.50,35.50,53.25 
BENTLEY, DICK,40012 

2.75,40.00,110.00 
BROWN, JANE,36115 

3.00,40.00,120.00 
UNDERWOOD, SAM.49230 

3.00,40.00,120.00 
*1INSERT-} 
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? 
D c 

»1L0AD ? 

.+2MODIFY ? 

X C &X,X C &X,F C &FB C &B1D C 

•1 ? 

»B C #1 

? 

•/ 



34821 

1.50,35.50,53.25 
40012 

2.75,40.00,110.00 
36115 

3.00,40.00,120.00 
49230 

3.00,40.00,120.00 
*1,2DELETEp 
• WRITE /PAY2/ ? 
NEW FILE ? 
35 WORDS. 
*QUIT ? 

In this example, the user wishes to delete the alpha- 
betic strings from every other line of text in the text 
area. Perhaps he wishes to use the data as input to a 



program that will not read strings. He first inserts two 
blank lines at the beginning of the text area. Then he 
loads buffer 1 with the following: 

.+2MODIFY ? 
X C ,X C ,F C B C 1 

He then sets the current line to the first line of text 
by typing the line number 1 followed by a Carriage 
Return. Now he calls buffer 1. EDITOR takes the 
command .+2MODI FY from the buffer. Since the cur- 
rent line is the first line of text and the first two lines 
of text are the inserted Carriage Returns, the line 
edited by this command is 

ADAMS, JOHN,34821 

The X c , deletes characters up to and including the 
first comma; a second X c , deletes the rest of the 
name. Then the F c copies the rest of the old line, 
without printing it, and ends the edit. Now the stored 
B c 1 calls buffer 1 again. At this point, the current line 
is defined as the line just edited since a MODIFY has 
just been executed. Thus, when buffer 1 is called 
again, .+2MODI FY allows edit of the line 

BENTLEY, DICK,40012 

EDITOR continues similarly, editing every other line 
in the text area. When the end of the text area is 
reached, .+2 is no longer defined, so EDITOR prints 
a question mark and returns control to the user. The 
user prints his text, deletes the two "dummy" lines 
from the beginning, and writes the text on a file. 
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SECTION 6 
EDITING EXAMPLES 

In this section we present five editing examples in increasing order of complexity. 

The examples in the previous sections of this manual were intended to demonstrate the 
functions of EDITOR'S various commands and control characters. The examples in this 
section, however, are intended to suggest possible applications of the EDITOR language, 
as well as to demonstrate various editing techniques. 

These examples are reproduced from actual terminal printout to help give the reader 
the feel of on-line use of EDITOR. Remember, though, the best way to get the feel of 
on-line text editing is to do it. 

CREATING A PROGRAM IN EDITOR 

EDITOR is frequently used to create a program in another language, such as Tymshare 
BATCH FORTRAN. This example illustrates preparing a BATCH FORTRAN program. It 
shows the user typing his program, doing some simple editing, and then writing the pro- 
gram on a file which will later be used as input to the BATCH FORTRAN compiler. 

Note the use of the TABS command to set a tab stop at print position 7 and the use of 
control characters during APPEND and INSERT as well as during EDIT. 

-EDITOR 
♦TABS 7 
♦APPEND The user types his text l c is used to 

PEN C 5 » I NPUT > / DATA/ ) ^ ace to tne tab stop at print posi- 

ASSIGN 55 TO K t , on 7. 

CALL EOFCL) 

B=0 

2 READ (5*3) A 

B=V«-B+A A c deletes the preceding character, V. 
GO TO 2 
55 WRITE (1*4) B 

3 FORMAT CF9.0) 

4 FORMATCS THE SUM IS $>F10.3) 
END 

♦ 1 INSERT 

C THIS PROGRAM ADDS ANY SEQUENCE OF NUMBERS. 
C INPIT IS FROM A FILE. SUM IS PRINTED AT TERMINAL.*^ 

C I NPU The user types Y c to allow an edit of J 

♦ ' EOF ' ED I T this line; then he types Z C PUF C . 

CALL EOFCL) 

CALL EOF(K The user types Z c ( and then types 

♦ ./ KF C . 

CALL EOFCK) 

♦ :4:EDIT 

4 FORMATCS THE SUM IS $*F10.3) 

4 FORMATCS THE SUM IS S*F10«3)-/) He types H c N c /) p 

♦./ 

4 FORMATCS THE SUM IS $*F10.3/) 

♦/ 

C THIS PROGRAM ADDS ANY SEQUENCE OF NUMBERS. 
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C INPUT IS FROM A FILE. SUM IS PRINTED AT TERMINAL. 
OPEN < 5* INPUT* /DATA/) 
ASSIGN 55 TO K 
CALL EOF(K) 
B=0 

2 READ (5*3) A 
B=B+A 

GO TO 2 
55 WRITE (1*4) B 

3 FORMAT (F9.0) 

4 FORMAT<$ THE SUM IS $*F10.3/) 
END 

♦WRITE /SUM/ 
NEW FILE 
89 WORDS. 
♦QUIT 



RETRIEVING RESUMES 

This example illustrates the usefulness of the FIND command for information retrieval. 
The user has a disk file containing brief resumes of company employees. Using EDITOR, 
it is very easy to update the file as well as to find an employee with a particular kind of 
experience. 

In the first part of the example, the user appends a new employee's resume\ Note that 
each physical line is terminated with a Line Feed to insure that the entire resume is 
printed when accessed with FIND. 

-EDITOR 



A new employee's resumS is ap- 
pended. The entire resume con- 
sists of one line made up of six 
physical lines. 



♦READ /RESUMES/ 

292 WORDS. 

♦APPEND 

HENRY C SMITH DEPT . 32 

B.A. UNIVERSITY OF TEXAS* MATHEMATICS 

SCIENTIFIC PROGRAMMING 

FORTRAN 

♦ ' YOUNG ' ED I T Michael Young's resume is updated. 
MICHAEL YOUNG DEPT. 622 

B.A. ENGLISH LITERATURE* IOWA STATE 

HARDWARE SALES 

BUSINESS PROGRAMMING 

COBOL 
BASIC 



MICHAEL YOUNG DEPT. 622 

B.A. ENGLISH LITERATURE. IOWA STATE 
< DIST. MANAGEMENT* MARKETING 
> 
♦ ./ 



The user types Z -^ twice, uses E c to 
insert some text, then types F°. 
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MICHAEL YOUNG DEPT. 622 

B.A. ENGLISH LITERATURE* IOWA STATE 
DIST. MANAGEMENT* MARKETING 
HARDWARE SALES 
BUSINESS PROGRAMMING 

COBOL 
BASIC 



The updated resumes are written on 
the file /RESUMES/. 



♦WRITE /RESUMES/ 

OLD FILE 

336 WORDS. 

♦FIND 'SCIENTIFIC AND 'ALGOL'/ 

JOHN B. CAREY DEPT. 3H 

PH D MATHEMATICS YALE UNIVERSITY 

PROJECT MANAGEMENT* APPLICATIONS 

OPERATIONS RESEARCH 

SCIENTIFIC PROGRAMMING 



The user wants an experienced sci- 
entific programmer who knows 
ALGOL. 
PROGRAMMING 



FORTRAN 
ALGOL 

DONNA WILKES DEPT. A4 

PH D PHYSICS* STANFORD UNIVERSITY 
PROJECT MANAGEMENT* SYSTEMS PROGRAMMING 
SCIENTIFIC PROGRAMMING 
ON-LINE GRAPHICS 
SOFTWARE DEVELOPMENT 



FORTRAN 

ALGOL 

ASSEMBLY 



LANGUAGE 



U.C BERKELEY 



2 

♦FIND 'COMPUTER OPERATIONS' AND NOT 'MANAGE'/ 

DALE MOSS DEPT. 6 

B.S. ELECTRICAL ENGINEERING* 
SCIENTIFIC PROGRAMMING 
CIRCUIT DESIGN 
REAL TIME SYSTEMS 
COMPUTER OPERATIONS 



He wants someone with a back- 
ground in operations who is not a 
manager. 



FORTRAN 

BASIC 

ASSEMBLY LANGUAGE 



♦FIND 'PL-1 




♦FIND 'PL-1 

CARL LARSON 

GRADUATE 

DIVISION 

COMPILER 



AND 'BASIC'/ 



' OR 'BASIC'/ 

DEPT. 4B 
WEST HIGH SCHOOL 
MANAGER* SOFTWARE 
DESIGN 



There is no one who knows PL-1 
and BASIC, but were are three peo- 
ple who know one or the other. 



DEVELOPMENT 
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COMPUTER OPERATIONS 
USED CAR SALES 

FORTRAN 

PL-1 

ASSEMBLY LANGUAGE 

DALE MOSS DEPT. 6 

B.S. ELECTRICAL ENGINEERING* U.C BERKELEY 
SCIENTIFIC PROGRAMMING 
CIRCUIT DESIGN 
REAL TIME SYSTEMS 
COMPUTER OPERATIONS 

FORTRAN 

BASIC 

ASSEMBLY LANGUAGE 

MICHAEL YOUNG DEPT. 622 

B.A. ENGLISH LITERATURE* IOWA STATE 
DIST. MANAGEMENT* MARKETING 
HARDWARE SALES 
BUSINESS PROGRAMMING 

COBOL 
BASIC 

3 
♦QUIT 
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CREATING A DATA FILE WITH INPUT FROM PAPER TAPE 

In this example, the user has a paper tape containing sample data which he wants to 
use in a Tymshare statistical analysis library program. The tape contains the sample data 
separated by their frequencies; however, the user wishes to have only the data on the file, 
without the frequencies. He uses the SUBSTITUTE command to accomplish this. Note 
how using Control V and Control G with SUBSTITUTE increases the power of this 
command. 

-EDITOR 

♦TAPE 

261 .4*3* 2 70. 8* 4* 265. 4*2*261. 4* 7* 258. 1*3 

252.1*5*268.3*7*250.3*1*272.3*9*262.8*2*255.5*8 

249.6*5*280.9*9*270.3*3*263.2*8*2 58.3*2*2 56.3*3 

259.3*5*270.1*3*259.3*2*253.2*5*266.4*6 

♦SUBSTITUTE „ 

„ Here the user appends a comma to 

„ _ __ „ each line of text by substituting a 

„ comma followed by a Carriage Re- 

turn for a Carriage Return. V c pre- 

cedes each Carriage Return typed. 

♦/ 

261.4*3*270.8*4*2 65.4*2*261.4*7*2 58.1*3* 

252.1*5*268.3*7*250.3*1*272.3*9*2 62.8*2*255.5*8* 

249.6*5*280.9*9*270.3*3*263.2*8*2 58.3*2*256.3*3* 

259.3*5*270.1*3*259.3*2*2 53.2*5*266.4*6* 

♦SUBSTITUTE _ , w#*w#. 

„ „ -. nn it | it The frequencies are now deleted by 

' * " * substituting a comma for a comma 

followed by any character (G c ) fol- 
lowed by a comma. 
♦ / 

261.4*270.8*2 65.4*261.4*258.1* 

252.1*268.3*2 50.3*272.3*262.8*255.5* 

249.6*280.9*270.3*263.2*258.3*256.3* 

259.3*270.1*259.3*253.2*266.4* 

♦SUBSTITUTE 
it 

Now the commas are removed from 
FOR * 

the end of each line. 
•t 

WAIT? N 

4 

♦/ 

261.4*270.8*265.4*261.4*258.1 

252.1*268.3*250.3*272.3*262.8*255.5 

249.6*280.9*270.3*2 63.2*258.3*256.3 

259.3*270.1*259.3*253.2*266.4 

♦WRITE /DATA2/ 

NEW FILE 

45 WORDS. 

♦Q 
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CREATING A DATA FILE 
FROM SUPER BASIC DATA STATEMENTS 



In this example, the user has a SUPER BASIC program in which data is stored in DATA 
statements within the program. He wishes to change the program to read the data from a 
disk file. To do this, he first changes the DATA statements to a format acceptable for file 
input, writes them on a new file, and deletes them from the program. He then adds an 
OPEN statement to the program (necessary for file input/output) and changes the READ 
statements (used for DATA statement input) to INPUT FROM statements (used for file 
input). Last, he stores the edited program on a new file. 

Note the abbreviation of the conditionals used with FIND, the use of a buffer with 
MODIFY, and the selective use of the SUBSTITUTE command. 



The user wants to know where his DA TA 
statements are. The conditional expres- 
sion used assures him that no PRINT 
statements or comments containing the 
word DA TA are found. 



-EDITOR 

*READ /PROG/ 

1468 WORDS. 

♦FIND 'DATA' ANN 'PRINT' ANN 'REM' ANN '!'= 

PRINT?Y 

83 

71 1 DATA 5000000* 5398278* 5792597* 61 79 1 14* 655421 7* 69 14625* 7257469 

84 

712 DATA 7580363*7881446*8159 399*8413447*8643339*8849303*903199 5 
87 

713 DATA 9192433*9331928*9452007*9554345*9640697*9712834*9772499 
86 

714 DATA 9821356*9860966*9892759*9918025*9937903*99 53388*9965330 
87 

715 DATA 9974449*9981342*9986501*9990324*9993129*9995166*9996631 
88 

716 DATA 9997674*9998409*9998922*9999277*9999 519*9999683*9999793 
89 

717 DATA 9999867*9999915*9999946*9999966*99999 79*9999987*9999992 
90 

735 DATA . 5* . 75* .9* .95* .99* .999* .9999* .99J99*4E44 

8 

* 5L A D When buffer 5 is called during MODIF Y, the con trol charac- 

&X &X &F&B 5 ters in buffer 5 delete the SUPER BASIC line number and 

*83*90M0DIFY word DA TA from the beginning of each DA TA statement. 

#5*83*90/ 

5000000* 53982 78* 5792597* 61 79 1 14* 65542 1 7* 69 14625* 7257469 

7580363*7881446*8159399*8413447*8643339*8849303*9031995 

9192433*9331928*9452007*9554345*9 640697*9712834*9 772499 

9821356*98609 66*9892759*9918025*9937903*9953388*9965330 

9974449*9981342*998 6501*9990324*9993129*999 5166*9996631 

9997674*9998409*9998922*99992 77*9999519*9999683*9999793 

99998 67*9999915*9999946*9999966*9999979*9999987*9999992 

.5* .75* .9* .95* .99* .999* .9999* .99999*4E44 

*83*90WRITE /PR0GDATA/ 

NEW FILE 

145 WORDS. 

*83*90DELETE 

♦FIND 'OPEN'/ 
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954 OPEN T9> INPUT* 2 There is already a file opened as file 2. 
1 

♦ 1- 

10 Line 1 has SUPER BASIC line number 10. „ 

♦ 1 INSERT ^Statement 5, to open /PROGDATA/, 

5 OPEN /PROGDATA/, INPUT* 1 /s inserted 

♦SUBSTITUTE INPUT FROM 1: is substituted for READ. 

"INPUT FROM 1:" FOR "READ" 

WAIT? Y 

360 READ PCL9) 

OK?Y 

702 READ XCK) 

OK?Y 

910 PRINT "SAMPLE OBSERVATIONS MAY BE READ FROM ANY FILE OR TYPED" 

OK?N 

2 

♦:360s/ 

360 INPUT FROM 1: P(L9> 

♦ : 7 02 : / I — The new input statements look fine. 
702 INPUT FROM It X(K)_ 
♦WRITE /NPROG/ 
NEW FILE 
1314 WORDS. 
♦QUIT 
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CONVERTING FROM FORTRAN IV TO BATCH FORTRAN 

In this example, the user has a FORTRAN IV program on a disk file /FOR4/. He reads 
the program into EDITOR, changes it to a BATCH FORTRAN program, and writes the 
edited program on the file /BFOR/. Three main steps are involved in the conversion: 

1. Deleting FORTRAN IV line numbers. 

2. Arranging the program in the fixed format of BATCH FORTRAN. 

3. Substituting BATCH FORTRAN'S symbol for exponentiation (»*) with FORTRAN 
I V's symbol (t). 

Buffers used with MODIFY and FIND, and the SUBSTITUTE command are used to 
accomplish these steps. Note the use of Control G and the conditionals AND and NOT 
with the FIND command. 

-EDITOR 

*R /F0R4/ Note abbreviation of the READ command. 

91 WORDS. 

*/ 

READ C0>40> X 
IFCX-0>60>70*60 

F0RMATCF10.0) 

G=l 

A=(2*Gt3+X)/(3*Gt2) 

(ABSCA-GD-1E-7) 10*80*80 

G=A 

TO 20 

WRITE(1>50)X*A 

FORMAT (/.»$ THE CUBE ROOT OF $,F10.5>$ IS $,F10.7*/) 
TO 30 
105. 70 STOP 
110. END 

* 1 LOAD The control characters loaded into buffer 1 will 
&X &E &E&F&B 1 delete line numbers and insert 6 spaces in front 

* I * $M0 D I FY of each line when buffer 1 is called during the 

* 1 * / command 1,$MODIF Y. 

30 READ <0>40> X 

IF(X-0)60*70*60 

40 F0RMATCF10.0) 

60 G=l 

20 A=(2*Gt3+X)/(3*Gt2) 

IF (ABSCA-G3-1E-7)10*80*80 

80 G=A 

GO TO 20 

10 WRITE(1,50)X*A 

50 FORMATC/*$THE CUBE ROOT OF $>F10«5>$ IS $>F10.7*/> 

GO TO 30 

70 STOP 



10. 


30 


15. 


IFC 


20. 


40 


30. 


60 


40. 


20 


50. 


IF 


60. 


80 


70. 


GO 


80. 


10 


90. 


50 


100 


. GO 



END 
♦1LOAD 



The control characters now loaded into buffer 1 will delete three 
spaces from the lines accessed by FIND; that is, the lines with 
FORTRAN labels. 



&S&S&S&F&B1 

*FIND<!!>AND N0T<IF>AND N0T<G0>M0DI FY 

#18 8 lines were found and modified after the user typed B° 1. 

*/ 
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30 


READ (0*40) X 




IF<X-0)60*70>60 


40 


FORMAT(FIO.O) 


60 


G = l 


20 


A=(2*Gt3+X)/C3*Gt2) 




IF (ABSCA-G3-1E-7)10*80*80 


80 


G=A 




GO TO 20 


10 


WRITE(1*50)X*A 


50 


FORMAT C/*$THE CUBE ROOT OF 




GO TO 30 


70 


STOP 




END 


♦SUBSTITUTE 


"**•» FOR "t" 


WAIT? 


N 


2 




*/ 




30 


READ (0*40) X 




IFCX-0>60*70*60 


40 


F0RMATCF10.0) 


60 


G = l 


20 


A=(2*G**3+X)/C3*G**2> 



!*F10.5*$ IS $*F10.7*/) 



The SUBSTITUTE command 
IF (ABSCA-G3-1E-7) 10*80*80 above replaced each t that 
80 G=A was in this line with **. 

GO TO 20 
10 WRITEC1*50)X*A 
50 FORMAT(/*$THE CUBE ROOT OF $*F10.5>$ IS $*F10.7*/> 

GO TO 30 
70 STOP 
END 
♦WRITE /BFOR/ 
NEW FILE 
82 WORDS. 
*Q 
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APPENDIX A 
ERROR MESSAGES 



Bell 

EDITOR rings a bell when a control character is 
typed which tells it to do something impossible. For 
example, if the user types Control Z followed by a 
character that does not appear in the rest of the old 
line, EDITOR rings a bell. 

EDITOR also rings a bell the first time the user 
attempts to ALT MODE during APPEND, CHANGE, 
EDIT, MODIFY, INSERT, and LOAD, as a warning 
to the user. If ALT MODE is typed again, the com- 
mand is aborted. All work done during the command 
is lost. 

EDITOR takes no further action when the bell 
rings; the user may correct his error immediately and 
continue whatever he was doing when the bell rang. 
NOTE: When Z°, 0°, X c , or P° is followed by a 
character not appearing in the rest of the line, the 
control character, as well as the character, must be 
retyped. 

There are two cases when the ringing bell does not 
indicate an error: 

1 . Whenever Control G is typed, the bell rings. 

2. When EDITOR is called from the EXECUTIVE, 
the bell rings. 

LINE TOO LONG 

When a line longer than 256 characters is entered 
into the text area, this message is printed upon termi- 
nation of the command used to enter the line. The 
line entered is cut off so that only part of it is entered 
into the text area. 

MAXIMUM LOAD IS: 80 LINES IN 
AND 8 LINES IN 1 THRU 9 

This message is printed when more than eight lines 
are entered into buffer n during nLOAD, upon termi- 
nation of the LOAD. No information is retained in 
the buffer. 

During r/?LOAD and rjiGEl, 80 lines may be 
entered into buffer 0. Thus, during these commands 
the message is printed if r consists of more than 80 
lines and text is being entered into buffer 0, or if r 



consists of more than eight lines and text is being 
entered into one of buffers 1 through 9. In all cases, 
nothing is retained in the buffer. 

Question Mark (?) 

EDITOR responds with a question mark when the 
user types a command it cannot understand, such as a 
misspelled command, a command containing an incor- 
rect line address, or a READ command containing an 
incorrect file name. 

EDITOR will also respond with a question mark if 
it is commanded to do something impossible, such as 
to delete the tenth line when there are only eight lines 
of text, or print text which has been cleared. 

After the question mark, EDITOR gives another 
asterisk. 

TOO MANY LINES 

The commands MOVE, COPY, and aREAD oper- 
ate on a maximum of 512 lines. If the user attempts 
to apply one of these commands to more than 512 
lines, this message is printed. 

TOO MUCH TEXT 

If more than 60,000 characters are entered into the 
text area during any input command, EDITOR termi- 
nates the command and prints this message. Text en- 
tered up to the point where the command was termi- 
nated is retained in the text area. 

WHAT? 

If anything other than a Y or an N is typed in 
answer to a question asked by EDITOR, it responds 
with WHAT?. Then the correct response may be 
typed. EDITOR'S questions include: 

ALL? during CLEAR 

DOUBLESPACE? during PRINT 

PRINT? during FIND used with - and «- 

PRINT? and OK? during FIND used with DELETE 

WAIT? and OK? during SUBSTITUTE 
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APPENDIX B 
DEFINITION OF THE CURRENT LINE 



Immediately After 


The Current Line 


All Forms Of: 


(Addressed By .) Is: 


APPEND 


Last line appended (=$). 


BUFFER 


No effect. 


CHANGE 


Last line typed during CHANGE. 


CLEAR 


Not applicable. 


COPY 


First line copied and inserted. 


DELETE 


Line preceding first line deleted. 


EDIT 


Last line edited. 


FIND 


Last line in text area. 


/•FIND 


Last line in range r. 


GET 


Line preceding first line of text put into the buffer. 


INSERT 


Last line typed during INSERT. 


KILL 


No effect. 


LINES 


No effect. 


LOAD 


No effect. 


MODIFY 


Last line edited. 


MOVE 


Depends on which way lines are moved. 


PRINT 


Last line printed. 


PUNCH 


Last line punched. 


QUIT 


Not applicable. 


READ 


Last line in text area. 


SUBSTITUTE 


Last line in which substitutions were made. 


TABS 


No effect. 


TAPE 


Last line read from tape (=$). 


WRITE 


Last line written on the file. 


/ 


Last line printed. If ALT MODE is typed during 




command, . does not change. 


= 


Line addressed by the = command. 


•«- 


Line addressed by the ■*- command. 


~l 


Line printed by the "^command. 


t 


Line printed by the t command. 
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APPENDIX C 
THE TERMINAL 

THE TERMINAL KEYBOARD 1 



©0©©®©0©0O00 
00®®®©0O®@0§00 

000©00©0000e 



SHIFT 

Only those keys which are underlined in the keyboard 
diagram have a shift position. The SHIFT key oper- 
ates in the manner of an ordinary typewriter. The 
SHIFT characters are printed as they appear on the 
upper half of these keys, with the following excep- 
tions: 

SHIFT K = [ 

SHIFT L = \ 

SHIFT M = ] 

CTRL (Control) 

Any alphabetic key may be pressed in conjunction 
with this key. The resulting character, called a con- 
trol character, does not always print on the terminal. 
Control characters serve a variety of purposes depend- 
ing on when they are typed. Some languages, for ex- 
ample, use control characters as editing instructions 
to the computer. In the Tymshare manuals, a super- 
script c is used to designate control characters; for 
example. Control D is shown as D c . Note the follow- 
ing special control characters: 

J c = Line Feed 

M c = Carriage Return 

ALT MODE or ESCAPE 

This key is used to abort a command, interrupt the 
execution of a program, and/or return to the EXECU- 
TIVE. NOTE: On machines not having either the 
ALT MODE or the ESCAPE key, use SHIFT K c . 



HERE IS 

Not used in the Tymshare system. 

LINE FEED 

Advances the paper one line each time it is pressed. 
When the user is connected to the computer, the sys- 
tem automatically supplies a Carriage Return after 
every Line Feed. 

RETURN (Carriage Return) 

Returns the print head to the beginning of a line. The 
print head goes to the beginning of the next line only 
when the user is connected to the computer; that is, 
the system automatically supplies a Line Feed after 
every Carriage Return. 

RUB OUT 

Used in conjunction with the B.SP. button on the 
paper tape punch to delete characters punched in 
error. 

REPT (Repeat) 

Repeats any character on the keyboard (including a 

space) when pressed in conjunction with the desired 

character. 

BREAK 

DO NOT press this key; it causes a transmission inter- 
rupt and possible loss of program and data. 

NOTE: Maximum line width is 72 characters on most 
terminals. 



1 - This is the standard terminal keyboard. On individual machines, some keys may not exist or may be located differently than 

shown in this diagram. 
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The ON/OFF Controls 

The standard ON/OFF control is a three-position 
dial located on the front of the terminal and to the 
right of the keyboard. 

Standard ON/OFF Control 



OFF 
LINE ( J LOCAL 



LINE 

The terminal is ON and ready to be connected to the 
computer via the phone line. When the connection is 
made, the terminal is said to be "on line". 

OFF 

The terminal is OFF. 

LOCAL 

The terminal is ready for local ("off line") opera- 
tions; that is, operations to be performed when the 
terminal is not connected to the computer. Paper tape 
may be punched offline. 

Dial Option 

Instead of the ON/OFF controls just described, the 
terminal may have a six button Dial Option ON/OFF 
control located to the right of the keyboard: 



ORIG CLR ANS 



TST 



BUZ- 
LCL RLS 



oooooo 

Dial Option ON/OFF Control 

Four of these buttons are used in the Tymshare 
system: 

ORIG 

The terminal is ON (Originated) and ready to be 
connected to the computer. 

CLR 

The terminal is OFF (Cleared). 

LCL 

The terminal is ready for off-line (Local) opera- 
tions. 

BUZ-RLS (Buzzer Release) 

Turns off the buzzer which sounds when the paper 
supply is low. 



The Paper Tape Controls 

When the terminal is equipped with a paper tape 
punch and reader, the controls are on the left side of 
the terminal. 

Punch Controls 

REL. OFF 



oo 
oo 



B.SP. 



ON 



REL. 

Releases the paper tape so that the user can pull it 
through manually. 

OFF 

Turns the punch OFF. 

ON 

Turns the punch ON to punch the paper tape. 

B.SP. 

Back spaces the paper tape one frame each time the 
button is depressed. Used in conjunction with the 
RUB OUT key on the keyboard to delete erroneous 
characters. 

Standard Reader Controls 

START 



STOP 



FREE 

START 

Starts and continues paper tape reading. 

STOP 

Stops paper tape reading. 

FREE 

Frees the tape reader mechanism so the user can pull 

the tape through manually. 

Optional Reader Control Arrangement 

For terminals equipped with the Reader Control 
Arrangement option, the following control characters 
have special significance: 
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qc 

When typed on the keyboard or sent to the termi- 
nal by the computer, Q c will start the paper tape 
reader. 

S c 

When read from paper tape or sent to the terminal 
by the computer, S c will stop the paper tape reader. 

NOTE: Before either of these control characters 
will function, the paper tape reader must be loaded 
with paper tape and the reader controls must be set to 
START. 

How To Punch Paper Tape Off Line 

The user can punch a paper tape while not con- 
nected to the computer. Later the tape can be read 
into the system by means of the READER command 
of the EXECUTIVE or the TAPE command of 
EDITOR. 

To punch paper tape off line, turn the dial on the 
front of the terminal to LOCAL and depress the ON 



button on the paper tape punch controls. Then punch 
the tape from the keyboard. Note the following spe- 
cial rules: 

• Always follow a Line Feed with a Carriage 
Return. 

• Always follow a Carriage Return with a Line 
Feed. 

Example 

Off line, type: On line, type: 

THIS IS^p equivalent to THIS IS-; 

LINE ONEp-j, equ i va i ent to UNE ONEp 

If the user makes a typing error while punching 
tape, delete the incorrect character immediately by 
depressing the B.SP. button on the punch controls 
and then the RUB OUT key on the keyboard. To de- 
lete several incorrect characters press B.SP. as many 
times as necessary and then RUB OUT the same num- 
ber of times. 



APPENDIX D 
EDITOR SUMMARY 
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SUMMARY OF EDITOR LINE ADDRESSES 


Kind Of 
Address 


Examples 


Example 


Function 


EDITOR 
Line Number 


5 


Addresses fifth line in text area. 


Text Within 
a Line 


'AB, 425' 
"AB, 425" 
[AB, 425] 


These three addresses address any line 
containing the text AB, 425. 


Line Label 


:123: 
<END> 


Addresses line having label 123 which be- 
gins in print position 1 . 

Addresses line having label END. This 
label may be preceded by any number of 
blanks. 


The Last Line 
of Text 


$ 


Addresses the last line in the text area. 


The Current Line 


• 


Addresses the current line. 


Address of a 
Range of Lines 


:34:,"BOB" 


Addresses all lines from the line with label 
34 (beginning in print position 1 ) to the 
line containing BOB, inclusive. 


Combination 
Line Addresses 


6:JONES:'SAN JOSE' 


Addresses first line containing SAN JOSE 
following the first line after line 6 that 
has label JONES. 


Address 
Arithmetic 


[DATA] +5 
-4 


Addresses fifth line after the line contain- 
ing DATA. 

Addresses fourth line before the current 
line. 
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ALPHABETIC SUMMARY OF EDITOR COMMANDS 

a = The address of a single line. 

r = The address of a single line or a range of lines. 

c = A line label or text address, or a conditional expression. 

n = A buffer number. 

t = Indicates that the command form may be used without the preceding address/* to 
apply to all lines in the text area. 



Command 


Forms 


Function 


APPEND 


APPEND p 


Enters text from terminal. 


BUFFER 


nBUFFERp 


Prints contents of buffer at the 
terminal. 


CHANGE 


/■CHANGE p 


Changes line or lines addressed to 
lines typed. 


CLEAR 


CLEAR p 


Erases contents of text area and 
buffers. 


COPY 


aCOPY rp 


Inserts a copy of the line or lines ad- 
dressed by r before the line ad- 
dressed by a. 


DELETE 


rDELETE p 
DELETE -j 


Deletes line or lines addressed. 
Deletes next line of text. 


EDIT 


rEDITp 

EDIT-^ 
EDITt 


Prints and allows edit of line or lines 

addressed. 

Prints and allows edit of next line. 

Prints and allows edit of previous 

line. 


FIND 


' tFIND c command 

rtFIND a, TO a 2 . c J^* nd 


Executes specified command for all 
lines in specified range satisfying the 
conditional expression or string ad- 
dress c. 

Executes specified command for all 
lines satisfying c which are also in 
each secondary range a^ TO a 2 in 
the range r. 


GET 


ryiGETp 


Enters the line or lines addressed in- 
to buffer n and deletes them from 
the text area. 


INSERT 


aINSERTp 


Inserts lines typed during the com- 
mand before the line addressed. 


KILL 


nKILLp 


Erases contents of buffer n. 


LINES 


LINES mp 


Sets/77 lines per page for PRINT. 


LOAD 


/7LOAD p 
/••/7LOAD p 


Enters information into buffer n 
from the terminal. 
Enters line or lines addressed into 
buffer n. 
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Command 


Forms 


Function 


MODIFY 


/•MODIFY j, 
MODIFY -j 
MODIFY t 


Allows edit of line or lines addressed 

without printing them. 

Allows edit of next line without 

printing it. 

Allows edit of previous line without 

printing it. 


MOVE 


aMOVE r p 


Moves the line or lines addressed by 
r before the line addressed by a. 


PRINT 


rtPRINTp 


Prints on the terminal in a page for- 
mat the line or lines specified. 


PUNCH 


rtPUNCH p 
rtPUNCH -j 


Punches line or lines specified on 
paper tape. EDITOR prints instruc- 
tions, punches D c at end of text. 
Punches specified text on paper 
tape. No instructions are given, no 
D c is punched. 


QUIT 


QUITp 


Returns to the EXECUTIVE. 


READ 


READp 
aREADp 


Enters contents of file specified in 
command into text area. 
Enters contents of specified file into 
text area before the line addressed 
by a. 


SUBSTITUTE 


/•tSUBSTITUTE p 

"any charactersD c " FOR " 

characters in text areaD c " 


Makes substitutions throughout the 
line or lines specified. 


TABS 


TABS number list p 


Changes tabs from initial settings to 
print positions specified in number 
list. 


TAPE 


TAPEp 


Enters text from paper tape into 
text area. 


WRITE 


rtWRITEp 
/•tWRITE-j, 


Writes line or lines specified to a 
file. Multiple blanks are compressed. 
Writes line or lines specified to a 
file. Multiple blanks are not com- 
pressed. 


/ 


rt/ 


Prints line or lines specified at the 
terminal. 


= 


a= 


Prints EDITOR line number of line 
addressed. 


•«- 


a<- 


Prints a line label address for line ad- 
dressed if the line has a label begin- 
ning in print position 1 . 


Line Feed 


~* 


Prints next line on the terminal. 


t 


t 


Prints previous line on the terminal. 
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ALPHABETIC SUMMARY OF CONTROL CHARACTERS 


Control 
Character 


Symbol 
Printed 


Function 


A c 


•«- 


Deletes preceding character. 


B<77 


#n 


Takes commands, text, and/or control characters from buffer n 
just as if they were typed at the terminal. 


C 




Copies and prints next character in old line. 


D c 




During EDIT and MODIFY, it copies and prints the rest of the old 
line to the new line and ends the edit. During APPEND, INSERT, 
and CHANGE, it terminates the command if used immediately 
after a Carriage Return; otherwise it copies the rest of the old line 
to the new line and ends the new line. 


E c texfE c 


< 
> 


Inserts text into old line to form new line; first E c prints <, sec- 
ond E c prints >. 


F c 




Copies but does not print the rest of the old line; ends the edit 
during EDIT and MODIFY; and ends the line during APPEND, 
INSERT, and CHANGE. 


G c 


! 


Used in SUBSTITUTE and line addressing to match any character; 
for example, XXG C means XX followed by any character. 


H c 




Copies and prints rest of old line and continues the edit at the end 
of the line. 


l c 




Spaces to next tab stop. 


Line Feed 
or J c 




Allows line continuation. 


K c 




Deletes next character in old line and prints it. 


Carriage 
Return 

or M c 




During EDIT and MODIFY, ends the new line and the edit. 


N c 


■*- 


Backspaces in the old and new lines. 


O c and a 
character 




Copies the old line up to but not including the character typed 
after it, printing the characters copied. 


P°and a 
character 


% 


Deletes characters from the old line up to but not including char- 
acter typed after it. 


Q c 


t 


Deletes preceding line. 


R c 




Copies and prints rest of old line plus the new line up to the point 
where R c was typed; continues edit at this point. 


S c 


% 


Deletes next character in old line. 


TC 




Same as R c except that it aligns the rest of the old line with the 
new line. 


U c 




Copies and prints the old line up to next tab stop in new line. 


V c 




Used before Carriage Return, Line Feed, or a control character to 
accept them as text (inhibit their usual functions). 


WC 


\ 


Deletes preceding word. 


X c anda 
character 


% 


Deletes characters from the old line up to and including the char- 
acter typed after it. 
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Y c 




Copies but does not print rest of old line and continues edit at the 
beginning of the new line. 


Z c and a 
character 




Copies the old line up to and including the character typed after 
it, printing the characters copied. 
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INDEX 



NOTE: Page numbers which appear in bold face type refer to those pages where the listed 
item receives the most detailed discussion. 



A c , 5, 23, 29, 35 
Address arithmetic, 1 6 
Addressing, see Line addressing 
ALTMODE or ESCAPE, 6, 8, 20, 66 
AND, 42, 45, 46 
APPEND, 5, 11,23,30 

B c , 51 

Backspacing, see N° 

Buffers, 49 
input to, 49 

from terminal, 49 

from text area, 50 
output from, 49 
storing commands in, 51 
storing control characters in, 52 
storing text in, 51 
use of, 50 
used recursively, 52 

C c , 27 

Calling EDITOR, 3 

Carriage Return, 13, 66, 68 
during EDIT and MODIFY, 29 

CHANGE, 23, 30, 32 

CLEAR, 47, 50 

Combination line addressing, 16 

Commands 

abbreviating, 8 
conventions for typing, 8 
editing, 23 
summary of, 70 

Conditional expressions, 41 , see also FIND, NOT, 

AND, OR 

evaluation of, 43 

Conditionals, abbreviation of, 44 

Conditionals, see Conditional expressions 

CONTINUE, 8 

Control characters, 5, 23, 66, see also individual 

characters 
summary of, 72 
used at any time, 23 



used during APPEND, INSERT, 

and CHANGE, 23, 30 
used during EDIT and MODIFY, 23, 25 
used for copying, 26 
used for deleting, 26, see also A c , N , OF, W° 

COPY, 32 

Copying characters, see C , D°, F c , H°, 0°, R°, T°, 

If, Y ,^ 

Copying lines, 32 

Current line, 15 

definition of after each command, 65 

D c , 5, 7, 27, 30 

DELETE, 7,31,38 

Deleting characters from a line, see A c , K°, N°, P°, 

Deleting characters using SUBSTITUTE, 35 
Deleting lines, 7, 31, see also OP 
Deleting words, see W c 

E c , 7, 29 

EDIT, 7, 23, 25,38 

Editing commands, table of, 23 

Error messages, 64 

F c , 27 

File input, see Input 

File naming rules, 21 

File output, see Output 

FIND, 36, 37 
basic forms, 37 
commands used with, 38 
conditionals used with, 41 
secondary range used with, 40 

G c , 36 
GET, 50 

H c , 28 

l c , 24, 35 

Input commands, table of, 1 1 
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Input of text, 5, 11 

from file, 12, see also READ 
from paper tape, 1 1, see also TAPE 
from terminal, 1 1 , see also APPEND 

Input to a buffer, 49 

INSERT, 23,30,32,38 

Inserting characters into a line, 29 

Inserting lines, 32 

J c , 29, see also Line Feed 

K c , 26 
KILL, 50 

Line addressing, 6, 13 
address arithmetic, 16 
addressing a range of lines, 16 
combination line addresses, 15 
control G used in, 36 
current line (.), 15 
last line of text($), 15 
line label, 14 
line number, 7, 14 
summary, 69 
text within a line, 7, 14 

Line continuation, 13, see also Line Feed 

Line, definition of, 13 

Line Feed, 13, 66, 68 

Line Feed command, 19, 47 

Line label, 14, see also Line addressing 

Line length, 13 

Line number, 14, see also Line addressing 

LINES, 18,47 

LOAD, 49, 50 

Log in procedure, 3 

LOGOUT, 4 

M c , 29, see also Carriage Return 
MODIFY, 23, 25, 38 
MOVE, 33 
Multiple blanks, 20 

N c , 29 

NOT, 41,45, 46 

O c , 27 

OR, 42, 45, 46 



Output commands, table of, 17 

Output from a buffer, 49 

Output of text, 6, 17 

to file, 6, 20, see also WRITE 

to paper tape, 19, see also PUNCH 

to terminal, 6, 18, see also /and PRINT 

P c , 26 

Paper tape, see Input and Output 

Paper tape, puncing off line, 68 

PRINT, 18 

PUNCH, 19 

Q c , 5, 24, 29, 35 
QUIT, 8,47 

R c , 28, 31 
READ, 12 

S c ,7 

Secondary range, 40, 41, see also FIND 

SUBSTITUTE, 7, 33 

substituting Line Feeds and Carriage Returns, 36 
substituting selectively, 34 

T c , 28, 31 

Tab stops 
setting, 47 
spacing to next, 24 

TABS, 47 

TAPE, 11,23 

Terminal, 66 

Terminal input, see Input 

Terminal output, see Output 

Text area, 4 
size of, 13 

U c , 27 

Utility commands, table of, 47 

V c ,36 

W c , 24, 35 
WRITE, 6, 20 

X c , 26 

Y c , 28, 30 
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Z c , 7, 27 

$, see Line addressing 

., see Current line. Line addressing 

. . ., 42, 43, 45, 46 

/ command, 6, 7, 18 

= command, 38, 48 

t command, 19, 47 

*- command, 38, 48 



